# monkeymcp

Provides monkey species data, generated movement journeys, and behavioral logs to your AI client. Useful as a working sample server for testing tool calling.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 125
- Author: jamesmontemagno
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/jamesmontemagno/MonkeyMCP
- Updated: 2026-09-29
- HTML: https://affpapa.org/en/nevibecode/mcp/monkeymcp

## What it does

Built on .NET 9.0, monkeymcp exposes animal profiles and simulated movement paths through Model Context Protocol tools. It uses `MonkeyService` to fetch and cache species records, while `MonkeyLocationService` synthesizes travel tracks, health metrics, and behavior routines such as feeding or grooming.

The server provides four callable tools: `GetMonkeys`, `GetMonkey`, `GetMonkeyJourney`, and `GetAllMonkeyJourneys`. Aside from standard I/O communication, the project includes an alternative Server-Sent Events setup running over HTTP on port `3001`.

Compiling from source code requires the .NET 9.0 SDK, so using the pre-built Docker container or the hosted Azure Functions address is the fastest way to get it running.

## Requirements
- Needs: Docker

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add monkeymcp -- docker run -i --rm docker.io/jamesmontemagno/monkeymcp:2.0.3
```

### Codex

**Platform CLI**
```bash
codex mcp add monkeymcp -- docker run -i --rm docker.io/jamesmontemagno/monkeymcp:2.0.3
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "monkeymcp": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "docker.io/jamesmontemagno/monkeymcp:2.0.3"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "monkeymcp": {
            "type": "stdio",
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "docker.io/jamesmontemagno/monkeymcp:2.0.3"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add monkeymcp docker run -i --rm docker.io/jamesmontemagno/monkeymcp:2.0.3
```

## When to use it
- test tool execution workflows with a structured mock dataset
- fetch species profiles and details by name
- generate travel coordinates and health stats for an animal
- simulate multi-point routes and daily activities for all monkeys

## Example prompts
- List all available monkey records using the GetMonkeys tool.
- Retrieve the travel path and health log for a baboon with GetMonkeyJourney.
- Find profile information for a specific monkey using GetMonkey.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
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