{
  "markdown": "# Teamwork MCP Server\n\n> Model Context Protocol server for Teamwork.com integration with Large Language\n> Models\n\n[![Go Report Card](https://goreportcard.com/badge/github.com/teamwork/mcp)](https://goreportcard.com/report/github.com/teamwork/mcp)\n[![Go](https://img.shields.io/badge/Go-1.27.0-blue.svg)](https://golang.org/)\n[![MCP](https://img.shields.io/badge/MCP-Compatible-green.svg)](https://modelcontextprotocol.io/)\n\n📌 Are you a Teamwork.com user wanting to connect AI tools to your Teamwork.com\nsite right now? Jump straight to the **[Usage Guide](docs/usage/README.md)** for\ntokens, enabling MCP, and client configuration examples.\n\n## 📖 Overview\n\nThis MCP (Model Context Protocol) server enables seamless integration between\nLarge Language Models and Teamwork.com. It provides a standardized interface for\nLLMs to interact with Teamwork.com projects, allowing AI agents to perform\nvarious project management operations.\n\n### 🤖 What is MCP?\n\nModel Context Protocol (MCP) is an open protocol that standardizes how\napplications provide context to LLMs. This server describes all the actions\navailable in Teamwork.com (tools) in a way that LLMs can understand and execute\nthrough AI agents.\n\n## ✨ Features\n\n- **Multiple Transport Modes**: HTTP and STDIO interfaces for different deployment scenarios\n- **Secure Authentication**: Bearer token and OAuth2 integration with Teamwork.com\n- **Tool Framework**: Extensible toolset architecture for adding new capabilities\n- **Production Ready**: Comprehensive logging, monitoring, and observability\n- **Read-Only Mode**: Optional restriction to read-only operations for safety\n\nSee the auto-generated **[Tool Reference](docs/tool-reference.md)** for every\ncreate/read/update operation exposed across Projects, Desk, Spaces, and Chat, or\nbrowse the same catalogue with per-tool descriptions and a search filter at\n**[teamwork.github.io/mcp](https://teamwork.github.io/mcp/)**.\n\n## 🚀 Available Servers\n\nThis project provides three different ways to interact with the Teamwork.com MCP\nserver:\n\n### 📡 HTTP Server\n\nProduction-ready HTTP server for cloud deployments and multi-client support.\n\n**📖 [Full HTTP Server Documentation](cmd/mcp-http/README.md)**\n\nQuick start:\n```bash\nTW_MCP_SERVER_ADDRESS=:8080 go run cmd/mcp-http/main.go\n```\n\n### 💬 STDIO Server\n\nDirect STDIO interface for desktop applications and development environments.\n\n**📖 [Full STDIO Server Documentation](cmd/mcp-stdio/README.md)**\n\nQuick start:\n```bash\nTW_MCP_BEARER_TOKEN=your-token go run cmd/mcp-stdio/main.go\n```\n\n### 🛠️ HTTP CLI\n\nCommand-line tool for testing and debugging MCP server functionality.\n\n**📖 [Full HTTP CLI Documentation](cmd/mcp-http-cli/README.md)**\n\nQuick start:\n```bash\ngo run cmd/mcp-http-cli/main.go -mcp-url=https://mcp.example.com list-tools\n```\n\n## 📋 Prerequisites\n\n- Go 1.27 or later\n- Valid Teamwork.com API credentials (bearer token or OAuth2 setup)\n\n## 🧪 Development & Testing\n\n### Running Tests\n```bash\n# Run all tests\ngo test ./...\n\n# Run specific package tests\ngo test ./internal/twprojects/\n```\n\n### MCP Inspector\nFor debugging purposes, use the [MCP Inspector tool](https://github.com/modelcontextprotocol/inspector):\n\n```bash\nNODE_EXTRA_CA_CERTS=letsencrypt-stg-root-x1.pem npx @modelcontextprotocol/inspector node build/index.js\n```\n\n> [!IMPORTANT]\n> **Note**: The `NODE_EXTRA_CA_CERTS` environment variable is required when\n> using OAuth2 authentication with the Let's Encrypt certification authority.\n> Download the certificate [here](https://letsencrypt.org/certs/staging/letsencrypt-stg-root-x1.pem).\n\n## 🏗️ Architecture\n\n```\n├── cmd/\n│   ├── mcp-http/          # HTTP server implementation\n│   ├── mcp-stdio/         # STDIO server implementation\n│   ├── mcp-http-cli/      # CLI tool for testing via HTTP\n│   ├── mcp-test/          # Walks tool handlers against a real site\n│   ├── mcp-tokens/        # Token-cost report for the tool surface\n│   └── docs-gen/          # Generates the tool reference (Markdown + GitHub Pages)\n├── pkg/                   # Importable by other MCP servers built on this one\n│   ├── auth/              # Authentication helpers (bearer & OAuth2 token handling)\n│   ├── cli/               # -toolsets flag parsing\n│   ├── config/            # Configuration management (env, flags), MCP server setup\n│   ├── helpers/           # Shared utility functions (errors, link helpers, tool parsing)\n│   ├── request/           # HTTP request primitives / Teamwork API wiring\n│   ├── testutil/          # Product-neutral test mocks\n│   ├── toolsets/          # Tool framework and registration logic\n│   └── twctx/             # Per-request values derived from the bearer token\n├── internal/              # This server's own tools, not importable elsewhere\n│   ├── twprojects/        # Teamwork project/domain tools (tasks, tags, timers, etc.)\n│   ├── twdesk/            # Teamwork Desk tools (tickets, customers, etc.)\n│   ├── twspaces/          # Teamwork Spaces tools (spaces, pages, etc.)\n│   └── twchat/            # Teamwork Chat tools (conversations, messages)\n├── examples/              # Usage & integration examples (LangChain Node/Python)\n├── docs/usage/            # End-user setup & connection guide\n├── Makefile               # Common developer tasks\n├── Dockerfile             # Container build configuration\n├── CODE_OF_CONDUCT.md     # Community guidelines\n├── CONTRIBUTING.md        # Contribution guide\n└── SECURITY.md            # Security policy\n```\n",
  "bytes": 5460,
  "sha": "5aded31c9a169d1e0a601a0684be9310795dab86137e61c7bcde4b0b6741e161",
  "repo_slug": "teamwork/mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_teamwork_mcp_24c05971/readme"
}