# Narwhal

This MCP server for Claude Code connects agents to Narwhal’s financial and economic data API. It provides access to information about markets, economies, and companies.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: narwhalapi
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/narwhalapi/narwhalapi-mcp
- Updated: 2026-11-11
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/narwhal

## What it does

Narwhal links an MCP client to the hosted Narwhal API, whose tools cover financial and economic data. The local bridge forwards requests to that server; the server supplies the tool list.

The local bridge requires Node.js 20 or newer and a `NARWHAL_API_KEY`. Without the key, it exits with an error message. MCP clients that support remote connections can instead reach the server directly and authenticate with a Narwhal account or an API key in the `Authorization: Bearer <key>` header. That route does not launch the local bridge.

## Requirements
- Remote server: `https://api.narwhalapi.com/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://api.narwhalapi.com/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add narwhal --url https://api.narwhalapi.com/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "narwhal": {
            "url": "https://api.narwhalapi.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "narwhal": {
            "type": "http",
            "url": "https://api.narwhalapi.com/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http narwhal https://api.narwhalapi.com/mcp
```

## When to use it
- retrieve financial market data
- request economic indicators
- look up company data

## Example prompts
- Find data about financial markets.
- Get economic indicators for the United States.
- Show available data about a company.

## Similar
- [Context7](https://affpapa.org/en/nevibecode/mcp/context7.md) — MCP server · 5563 installs
- [Search Google Flights](https://affpapa.org/en/nevibecode/mcp/search-google-flights.md) — MCP server · 2595 installs
- [Math-MCP](https://affpapa.org/en/nevibecode/mcp/math-mcp.md) — MCP server · 5958 installs
- [pipeworx gateway](https://affpapa.org/en/nevibecode/mcp/pipeworx-gateway.md) — MCP server · 419019 installs
- [SparkForge](https://affpapa.org/en/nevibecode/mcp/sparkforge.md) — MCP server · 219896 installs
- [OpenWebSearch](https://affpapa.org/en/nevibecode/mcp/openwebsearch.md) — MCP server · 494 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
