Felt MCP

Felt MCP

An MCP server for interacting with Felt maps programmatically.

Prerequisites

• Python 3.14+
• uv
• A Felt API token

Configuration

Set your Felt API token as an environment variable:

export FELT_API_TOKEN=felt_pat_...

Running locally

uv sync
uv run python -m felt_mcp.main

The server uses stdio transport by default, which is the standard for MCP servers launched as subprocesses by an MCP client.

Running with Docker

docker build -t felt-mcp .
docker run -e FELT_API_TOKEN felt-mcp

MCP client configuration

Add this to your MCP client config (e.g. Claude Desktop claude_desktop_config.json):

{
  "mcpServers": {
    "felt": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/felt-mcp", "python", "-m", "felt_mcp.main"],
      "env": {
        "FELT_API_TOKEN": "felt_pat_..."
      }
    }
  }
}

Or with Docker:

{
  "mcpServers": {
    "felt": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "FELT_API_TOKEN", "felt-mcp"],
      "env": {
        "FELT_API_TOKEN": "felt_pat_..."
      }
    }
  }
}

Available tools

list_maps

Lists all maps accessible to the authenticated Felt user. Returns maps from all projects with their id, title, URL, project, and access level.

get_map_details

Get details for a specific Felt map, including its layers, elements, and settings.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | map_id | string | Yes | The ID of the map to retrieve |

get_map_layers

List all layers on a specific Felt map.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | map_id | string | Yes | The ID of the map whose layers to list |

create_new_map

Create a new Felt map with an optional title and initial viewport.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | title | string | No | Title for the new map | | lat | float | No | Initial latitude | | lon | float | No | Initial longitude | | zoom | int | No | Initial zoom level |

Development

uv sync                # install all dependencies including dev
just lint              # format, lint, and type check
just test              # run test suite
just test-failed       # re-run previously failed tests

License

See LICENSE.md.