LOCALSOURCE

Local Source Connect Console

Connect your agent to local business data.

A small account console for keys, MCP setup, usage, and testing. The product experience stays in your agent or API client.

Account access

Revocable key

Creating a new key with the same email revokes prior self-service keys for that account.

Test the API

Live API

Connect an agent

Hosted MCP

Let your agent set it up

Create a Local Source API key using https://staging.getlocalsource.com/auth.md, then follow https://staging.getlocalsource.com/agent-quickstart.md to integrate Local Source into this codebase.
Server
https://your-domain.com/api/mcp
Auth
Bearer token
Status
Create or paste a key

Codex setup prompt

Please connect Codex to Local Source.

Local Source is a query-only local business data service. It searches stored local business profiles. Do not use it to start scraping jobs.

Connection details:
- MCP server name: local-source
- MCP server URL: https://your-domain.com/api/mcp
- Authentication type: Bearer token
- Bearer token: <CONNECTION_KEY>

Codex setup:
- Add a remote MCP server named local-source.
- URL: https://your-domain.com/api/mcp
- Header: Authorization: Bearer <CONNECTION_KEY>
- If remote MCP is not enabled in this Codex environment, use the local stdio fallback below.

First, try hosted or remote MCP using the URL and bearer token above.

If Codex cannot use hosted or remote MCP servers, use local stdio MCP setup instead:
- Command: node
- Args: /absolute/path/to/agent-map-data/src/mcp/index.mjs
- Environment:
  - AMD_API_KEY=<CONNECTION_KEY>

Do not commit or expose the bearer token. Store it only in the client-approved local secret or MCP config location.

After setup, reload or restart MCP tools if needed.

Verify that the available tools include:
- search_places
- get_place
- count_places
- list_categories
- get_usage

Then run this connection test:
- Call list_categories with query="dent" and limit=5.

If that works, say exactly:
"Local Source is connected."

If setup fails, explain the blocker in plain English and tell me whether the issue is hosted MCP support, bearer-token auth support, local stdio setup, missing Node.js, or missing repo path.

Playground results

Create or paste an API key, then run a search.

REST example

curl -s https://your-domain.com/api/v1/places/search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"categories":["dentist"],"states":["MI"],"limit":5}'

MCP config

{
  "mcpServers": {
    "local-source": {
      "url": "https://your-domain.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Test prompt

Use Local Source.

First, call list_categories with query="dent" and limit=5.

Then search for 10 HVAC contractors in Michigan that have websites.

Return a table with:
- name
- city
- phone
- website_url
- rating
- review_count
- last_seen_at

If you hit a rate limit, wait according to retry_after_seconds or tell me the retry_after_seconds value.