Connect your AI agent
You can connect your own AI agent to your SkaldMaps account and work in plain language:
- "Find me an affordable Seattle suburb. I work at 400 Pine St."
- "Is 98052 high in median household income?"
- "Compare 98052 and 98033 on commute time and home values."
The agent searches the same data you see in the app and builds and runs searches for you. Every search it runs is saved to your account, and the agent gives you a link to it, so nothing it finds is lost: it opens in the app with its criteria, requirements and locations, such as your work address, in place. As you refine it in the chat, adding or dropping what matters to you, the agent updates that same search; ask for something different, such as another region, and it starts a new one. It never overwrites a search you already had without asking you first, including when your plan has room for only one.
Every plan can connect an agent, Free included.
By Tool
The URL is:
https://app.skaldmaps.com/mcp
You can also find it in the app under Account → Connected AI agents.
Claude (claude.ai and Claude Desktop)
- Open Settings → Connectors and choose Add custom connector.
- Paste the connector URL and save.
- Choose Connect. A SkaldMaps window asks you to sign in and approve access.
ChatGPT
- In ChatGPT's settings, add a custom connector (MCP server).
- Paste the connector URL and choose OAuth authentication.
- Approve access in the SkaldMaps window that opens.
Claude Code
claude mcp add --transport http skaldmaps https://app.skaldmaps.com/mcp
Then run /mcp in Claude Code and choose skaldmaps to sign in.
Cursor
Add SkaldMaps to ~/.cursor/mcp.json:
{ "mcpServers": { "skaldmaps": { "url": "https://app.skaldmaps.com/mcp" } } }
Then connect it from Cursor's MCP settings and sign in.
Codex
codex mcp add skaldmaps --url https://app.skaldmaps.com/mcp
codex mcp login skaldmaps
The second command opens SkaldMaps in your browser to sign in and approve.
What to ask
Describe what you want the way you would to a friend who knows the data: your budget, your commute, the kind of place (city, suburb, small town, rural), what matters for your household, and the states you're looking in. Give addresses for work, school or family, and the agent measures distance from them.
Then keep talking. "Make schools matter more", "drop the commute", "only places under 30 minutes from work": each change updates the same search and ranks again. Ask for something clearly different, like another region, and the agent starts a new search.
You can find an example here.
Your searches
Every search the agent runs is saved to your account, and the agent gives you a link to it. Open it in the app to see it on the map, change it yourself, or keep refining it in the chat. The agent never overwrites a search you already had without asking you first. If your plan keeps only one search, it tells you which one would be replaced and waits for your yes.
Plans
Connecting an agent is free on every plan. Free includes 20 agent calls a month: each step the agent takes, like looking up an address or ranking places, is one call, and a search usually takes a handful. The count starts over on the 1st of each month. Premium has no monthly limit.
The agent can do what your plan can do in the app: on Free that means a few criteria, requirements and states, and one saved search, with some fields locked. When your question needs more, the agent says what Premium would add rather than guessing.
What the agent can do
With your approval, the agent can read SkaldMaps data and create and edit your searches and saved locations. It can't delete searches, change your account or see your billing. Plan limits apply the same as in the app: a locked field stays locked, and the agent tells you when an upgrade is needed.
What you tell your assistant, and the results it gets from SkaldMaps, are handled by your AI provider under its own terms.
Disconnecting
Go to Account → Connected AI agents and choose Disconnect. Changing your password also disconnects every agent.