---
title: "Narwhal API MCP Server | Connect AI Tools"
description: "Connect Claude Code, Cursor, VS Code and other MCP clients to Narwhal's hosted read-only financial data server."
url: "https://narwhalapi.com/mcp"
---

# Narwhal API MCP server

Connect AI tools to read-only economic and financial data through one authenticated MCP endpoint.

[Get a free API key](https://narwhalapi.com/signup)

Narwhal hosts one stateless Streamable HTTP MCP endpoint for read-only financial data tools. It uses the same API key, response schemas and credit balance as the [REST API](https://narwhalapi.com/docs/api.md).

**Endpoint**

`https://api.narwhalapi.com/mcp`

Authentication: sign in with your Narwhal account. If a client cannot sign in, send `Authorization: Bearer YOUR_NARWHAL_API_KEY`

## Connect a client

Choose the client-specific connection guide:

### Claude Code

Add the remote HTTP server from the command line and sign in.

[Claude setup guide →](https://narwhalapi.com/docs/mcp/claude.md)

### Cursor

Add the Narwhal server to `.cursor/mcp.json` and sign in.

[Cursor setup guide →](https://narwhalapi.com/docs/mcp/cursor.md)

### VS Code

Add the Narwhal server to `.vscode/mcp.json` and sign in.

[VS Code setup guide →](https://narwhalapi.com/docs/mcp/vscode.md)

Other MCP clients can add the same endpoint and sign in. A client that cannot sign in needs authenticated Streamable HTTP and a configurable `Authorization` header. Read the [protocol-neutral MCP guide](https://narwhalapi.com/docs/mcp.md).

## Tool catalogue

Use `tools/list` after authentication to discover the tools enabled for the current public release. The detailed catalogue and matching REST references are maintained in the [MCP documentation](https://narwhalapi.com/docs/mcp.md#tools).

`Economics` `FX` `Physical palm oil` `Economic releases` `Public holidays` `Government bond yield curves`

The available tools can vary with the current public release. Check the tool list after connecting and use the linked reference for each operation.

## Access and credit

| Rule | Meaning |
| --- | --- |
| Sign-in | Sign in with your Narwhal account and choose Allow. No key is needed. |
| API key | If a client cannot sign in, create a Narwhal account and send the key as an HTTP Bearer token. See [authentication](https://narwhalapi.com/docs/authentication.md). |
| Read-only tools | MCP tools retrieve published data; they do not mutate your account or upstream sources. |
| Credit | Initialization and `tools/list` are free. Each successful `tools/call` costs one call at the price of its API, from the same balance as REST. |
| Errors | Tool errors expose the same public status, code, detail and request ID model as REST. See [errors](https://narwhalapi.com/docs/errors.md). |

## Discovery files

Machine-readable server descriptions:

- [`/server.json`](https://narwhalapi.com/server.json) — endpoint and authentication details in MCP Registry format.
- [`/.well-known/mcp.json`](https://narwhalapi.com/.well-known/mcp.json) — the same endpoint and authentication details as an MCP server card, at the path agents check first.
- [`/.well-known/mcp/server-card.json`](https://narwhalapi.com/.well-known/mcp/server-card.json) — an experimental MCP Server Card.

These files describe the endpoint and authentication requirement. They do not replace runtime authentication or `tools/list`.

Was this page helpful?
