Developer API

1. Sign up and upgrade to Analyst Solo, Analyst Team, or Platform Developer.
2. Create an API key in your dashboard.
3. Call any endpoint with Authorization: Bearer imc_….

curl "https://nmycity-api.onrender.com/api/v1/data/products/neighborhood-safety?\
scope=city&scopeId=2507000&start=2024-01-01&end=2024-12-31" \
  -H "Authorization: Bearer imc_YOUR_API_KEY"

Connect nMyCity from Cursor, Claude Desktop, or any MCP host. We ship two stdio servers — both thin clients over the same REST API, with the same auth, quotas, and attribution.

Combined Cursor config

{
  "mcpServers": {
    "nmycity": {
      "command": "npx",
      "args": ["-y", "@nmycity/mcp"],
      "env": {
        "NMYCITY_API_URL": "https://nmycity-api.onrender.com",
        "NMYCITY_API_TOKEN": "imc_YOUR_API_KEY"
      }
    },
    "nmycity-oracle": {
      "command": "npx",
      "args": ["-y", "@nmycity/oracle-mcp"],
      "env": {
        "NMYCITY_API_URL": "https://nmycity-api.onrender.com",
        "NMYCITY_API_TOKEN": "imc_YOUR_BUSINESS_API_KEY",
        "NMYCITY_ORACLE_ATTESTATION": "prohibited-use-accepted-v1"
      }
    }
  }
}

Legacy aliases still work during migration: @inmycity/mcp, @inmycity/oracle-mcp, and env vars INMYCITY_*. Create keys in Dashboard → API keys. Monorepo contributors: copy .cursor/mcp.json.example to .cursor/mcp.json and run npm run build:mcp:all for local node packages/*/dist paths.

Requires Pro, Analyst, or Platform Developer tier. Tools:

• search_places — resolve place_id from address or neighborhood
• query_civic_data — per-domain counts for a scope and date range
• get_neighborhood_safety_bundle — multi-domain safety product in one call
• list_domains — domain catalog

Resources: API docs index, model cards, source freshness.

Separate server for the Civic Oracle API. Requires Business tier, a passing fairness audit on the API deployment, and explicit acceptable-use attestation before the server will start.

Read and accept the Oracle acceptable-use policy before setting NMYCITY_ORACLE_ATTESTATION=prohibited-use-accepted-v1 in your MCP config (legacy: INMYCITY_ORACLE_ATTESTATION; REST clients use header X-nMyCity-Attestation, legacy X-InMyCity-Attestation).

Tools:

• search_places — resolve place_id
• list_oracle_products — product catalog and attestation requirements
• get_place_index — decomposed Neighborhood Trajectory Index + lineage
• get_place_trajectory — current index + historical values
• get_index_validity — O2 out-of-sample backtest report

REST equivalents: GET /api/v1/oracle/index, /trajectory, /validity. Oracle rate limit: 60 requests/min (Business), 120/min (Enterprise).

• API index (JSON)
• OpenAPI 3.0 spec
• Trust & Data — sources and freshness

Responses include X-RateLimit-Limit-Monthly and X-RateLimit-Remaining-Monthly headers. Every payload includes per-domain attribution (source, method, warehouse table).