Docs

deep.navy is a remote MCP server over Streamable HTTP at mcp.deep.navy. Any MCP client that can call a tool can call these tools; there is no SDK to install. The same operations are a Connect API, JSON over HTTP, and native gRPC at api.deep.navy, with the same key.

Tool names are unique across toolsets, so a tool appears once on /mcp. Tool arguments and results are protojson, so field names are camelCase and enums are their proto names, such as RECENCY_WEEK.

Endpoints

Every endpoint is https://mcp.deep.navy/ followed by the path below.

Path	Tools
/mcp	Every tool you have switched on, in one place.
/fetch	`web_fetch`, `web_versions` and `web_diff`: any URL as markdown, text or HTML, with its stored versions and diffs. Docs GA
/news	`news_search`, with `web_fetch` to open a result: news articles with freshness, date, domain and `near` location filters. Docs GA
/edgar	`edgar_search` and `edgar_fetch`: 10-K, 10-Q and 8-K filings by company, form type and date; sections and XBRL facts. Docs GA
/geo	`geo_search`, `geo_fetch` and `geo_places`: Sentinel-2, NOAA GOES, HRRR and ISD as STAC 1.1, and Overture Maps places. Docs GA
/people	`people_search`, with `web_fetch` to open a result: public profile pages, self-published fields only. Docs Beta
/monitors	`monitor_create`, `monitor_list`, `monitor_get`, `monitor_delete`, `monitor_pause`, `monitor_resume` and `monitor_runs`: saved searches delivered to a signed webhook. Docs Beta
/mcp	Search GLEIF legal entities and fetch their identifiers, addresses, registration status and reported parent relationships. Docs
/mcp	Read National Weather Service forecasts and active alerts for a US location, with source links, units and update times. Docs
/mcp	Find reviewed World Development Indicators and read annual observations by country, with definitions, dates and source attribution. Docs
/mcp	Discover supported US Energy Information Administration datasets and fetch energy observations with their original units and source links. Docs

Authentication

Create a key in the dashboard and send it as a bearer token on every request. The secret is shown once; revoke a lost key and create another.

			Authorization: Bearer dn_live_…

A call to a tool you have switched off, or that is not in your plan, returns -32602 Unknown tool. A change to your switches reaches a connected agent on its next tools/list, within about a minute.

Fetch

web_fetch, web_versions and web_diff: any URL as markdown, text or HTML, from the cache or live, with every stored version and the diff between any two.

Read the fetch docs

News

news_search with recency, date and domain filters, and a near filter that locates each article by its dateline, its content or its publisher, with the evidence.

Read the news docs

SEC EDGAR

edgar_search and edgar_fetch: filings by company, form and date, one section of a filing such as Item 1A, and XBRL facts under the company's own tags.

Read the EDGAR docs

Geospatial

geo_search, geo_fetch and geo_places: Sentinel-2, NOAA GOES, HRRR and ISD as STAC 1.1 by place, time and filters, and Overture Maps places.

Read the geo docs

Monitors

Turn any news, EDGAR or geo search into a signed webhook, in realtime or as an interval digest. Create one in the dashboard or let your agent create it with the monitor_* tools.

Read the monitors docs

People

people_search returns the self-published fields of public profile pages, with the rule that decided each page is a profile, and never an email address or a phone number. Source details and removal instructions are in the people docs.

Read the people docs

Company identity

Search GLEIF legal entities and fetch their identifiers, addresses, registration status and reported parent relationships.

Read the docs and source references

Weather

Read National Weather Service forecasts and active alerts for a US location, with source links, units and update times.

Read the docs and source references

World Bank indicators

Find reviewed World Development Indicators and read annual observations by country, with definitions, dates and source attribution.

Read the docs and source references

Energy

Discover supported US Energy Information Administration datasets and fetch energy observations with their original units and source links.

Read the docs and source references

Client configuration

Claude Code takes the endpoint as one command, Cursor reads it from mcp.json, and Claude Desktop reaches it through the mcp-remote bridge.

claude mcp add --scope user --transport http deepnavy https://mcp.deep.navy/mcp \
  --header "Authorization: Bearer $DEEPNAVY_KEY"

One command registers deep.navy as a remote MCP server. Keep the key in an environment variable, not in the command. User scope makes deep.navy available in every project; --scope project writes a shareable .mcp.json for a team repo instead.

{
  "mcpServers": {
    "deep-navy": {
      "url": "https://mcp.deep.navy/mcp",
      "headers": {
        "Authorization": "Bearer <your key>"
      }
    }
  }
}

Paste this into mcp.json and replace <your key> with a key from your dashboard.

{
  "mcpServers": {
    "deep-navy": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.deep.navy/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer <your key>"
      }
    }
  }
}

Claude Desktop starts local commands from claude_desktop_config.json, so it reaches deep.navy through the mcp-remote bridge, which needs Node.js. Replace <your key> with a key from your dashboard; the header has no space after the colon because some clients do not escape spaces in arguments.

https://mcp.deep.navy/mcp

Streamable HTTP, stateless, bearer auth. A toolset's own endpoint works the same way, for example https://mcp.deep.navy/edgar for the two EDGAR tools.

For a core toolset listed with a dedicated endpoint above, you can use that endpoint instead of /mcp; the key is the same.