# 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](/docs/fetch) GA | | /news | `news_search`, with `web_fetch` to open a result: news articles with freshness, date, domain and `near` location filters. [Docs](/docs/news) 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](/docs/edgar) 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](/docs/geo) GA | | /people | `people_search`, with `web_fetch` to open a result: public profile pages, self-published fields only. [Docs](/docs/people) 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](/docs/monitors) Beta | | /mcp | Search GLEIF legal entities and fetch their identifiers, addresses, registration status and reported parent relationships. [Docs](/docs/company) | | /mcp | Read National Weather Service forecasts and active alerts for a US location, with source links, units and update times. [Docs](/docs/weather) | | /mcp | Find reviewed World Development Indicators and read annual observations by country, with definitions, dates and source attribution. [Docs](/docs/worldbank) | | /mcp | Discover supported US Energy Information Administration datasets and fetch energy observations with their original units and source links. [Docs](/docs/energy) | ## 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](/docs/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.](/docs/fetch) [Read the fetch docs](/docs/fetch) ## [News](/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.](/docs/news) [Read the news docs](/docs/news) ## [SEC EDGAR](/docs/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.](/docs/edgar) [Read the EDGAR docs](/docs/edgar) ## [Geospatial](/docs/geo) [`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.](/docs/geo) [Read the geo docs](/docs/geo) ## [Monitors](/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.](/docs/monitors) [Read the monitors docs](/docs/monitors) ## [People](/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.](/docs/people) [Read the people docs](/docs/people) ## [Company identity](/docs/company) [Search GLEIF legal entities and fetch their identifiers, addresses, registration status and reported parent relationships.](/docs/company) [Read the docs and source references](/docs/company) ## [Weather](/docs/weather) [Read National Weather Service forecasts and active alerts for a US location, with source links, units and update times.](/docs/weather) [Read the docs and source references](/docs/weather) ## [World Bank indicators](/docs/worldbank) [Find reviewed World Development Indicators and read annual observations by country, with definitions, dates and source attribution.](/docs/worldbank) [Read the docs and source references](/docs/worldbank) ## [Energy](/docs/energy) [Discover supported US Energy Information Administration datasets and fetch energy observations with their original units and source links.](/docs/energy) [Read the docs and source references](/docs/energy) ## 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 Code** ``` 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. **Cursor** ``` { "mcpServers": { "deep-navy": { "url": "https://mcp.deep.navy/mcp", "headers": { "Authorization": "Bearer " } } } } ``` Paste this into `mcp.json` and replace `` with a key from your dashboard. **Claude Desktop** ``` { "mcpServers": { "deep-navy": { "command": "npx", "args": [ "mcp-remote", "https://mcp.deep.navy/mcp", "--header", "Authorization:${AUTH_HEADER}" ], "env": { "AUTH_HEADER": "Bearer " } } } } ``` 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 `` with a key from your dashboard; the header has no space after the colon because some clients do not escape spaces in arguments. **Any MCP client** ``` 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. --- This is the Markdown copy of https://deep.navy/docs.