{
  "markdown": "# Tallyfy MCP Server\n\n[![License: Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](./LICENSE)\n[![MCP](https://img.shields.io/badge/Model_Context_Protocol-server-5A45FF.svg)](https://modelcontextprotocol.io)\n\nThe official [Model Context Protocol](https://modelcontextprotocol.io) server for **[Tallyfy](https://tallyfy.com)**, the workflow and process automation platform. It lets any MCP-capable AI assistant run your operations: create and track tasks, launch and advance processes, read and edit templates, fill form fields, manage people and groups, and search across your organization, all through your own authenticated Tallyfy account.\n\n> **This repository is an automatically published, read-only mirror.** The canonical source is maintained privately by Tallyfy and a sanitized, server-only snapshot is published here on every production release. Please do not open pull requests against this mirror (they cannot be merged here). For bugs or feature requests, use the issue tracker or contact us (see [Support](#support)). Hosting, deployment, and monitoring code is intentionally not part of this mirror.\n\n## Connect (hosted, recommended)\n\nTallyfy runs a managed remote server. You do not need to host anything. Point your MCP client at:\n\n```\nhttps://mcp.tallyfy.com/\n```\n\nTransport is streamable HTTP and authentication is OAuth against your Tallyfy account, so the assistant only ever sees data the signed-in user is allowed to see.\n\n<details>\n<summary>Example client config</summary>\n\n```json\n{\n  \"mcpServers\": {\n    \"tallyfy\": {\n      \"type\": \"streamable-http\",\n      \"url\": \"https://mcp.tallyfy.com/\"\n    }\n  }\n}\n```\n</details>\n\n## What it can do\n\n113 tools across the Tallyfy domain, grouped by area:\n\n| Area | Examples |\n|------|----------|\n| Tasks | create, complete, reassign, comment on, and search tasks |\n| Processes (runs) | launch a process from a template, advance and track steps |\n| Templates (checklists) | read, create, and edit templates and their steps |\n| Form fields | read and populate kick-off and step form fields |\n| Automation | inspect and manage automated actions / rules |\n| People & access | users, groups, guests, organization membership |\n| Organization | tags, folders, comments, search across the org |\n| API fallback | read from or write to any Tallyfy REST endpoint that has no dedicated tool |\n| Product docs | search the public Tallyfy documentation index |\n| Org memory | read and update a per-organization memory document held server-side |\n\nAlmost every tool calls the public Tallyfy API on behalf of the authenticated user (the exceptions read the public docs index and the server-side org memory store). There are no write operations the signed-in user could not perform in the Tallyfy app directly.\n\n**Doing bulk or scripted work?** This server is tuned for interactive, conversational use and limits how much one request can do at once. For high-volume or headless automation (launching processes from a CSV, exporting every template to disk, multi-org loops, CI/CD approval gates), reach for the first-party [`tallyfy` CLI](https://github.com/tallyfy/cli) instead. It is built for deterministic, scriptable batch operations. Install with `brew install tallyfy/tap/tallyfy` or grab a binary from the [releases page](https://github.com/tallyfy/cli/releases).\n\n## Run it yourself\n\nYou can build and run the server from this mirror with Docker. No configuration is required to start it:\n\n```bash\ncd server\ndocker build -t tallyfy-mcp-server .\ndocker run --rm -p 9000:9000 tallyfy-mcp-server\ncurl http://localhost:9000/health      # {\"status\":\"healthy\"}\n```\n\nThe server listens on port `9000` and speaks streamable HTTP at `/` (and at `/mcp`). Python 3.13 is required if you prefer to run it without Docker (`pip install -r server/requirements.txt`, then `uvicorn server:app` from inside `server/`).\n\nTo configure it, copy [`.env.example`](./.env.example) to `.env` and pass it with `--env-file .env`. Every value in there is optional; the defaults point at Tallyfy production.\n\n### About authentication\n\nEvery MCP request needs a Tallyfy-issued OAuth 2.1 bearer token (RS256). The server verifies that signature on every call, so an unauthenticated client gets a `401` challenge and reaches no Tallyfy data. Only `/health` and the OAuth discovery documents are open.\n\nThe verification key is resolved for you. Left alone, the server reads Tallyfy's published JWKS at `https://account.tallyfy.com/.well-known/jwks.json` and picks up key rotations automatically. Set `TALLYFY_PUBLIC_KEY` to a PEM public key if you would rather pin it and avoid the network lookup. If neither source resolves, the server still starts, and rejects every token.\n\n## Listed on\n\n- [Official MCP Registry](https://registry.modelcontextprotocol.io) (`com.tallyfy/mcp-server`)\n- [GitHub MCP Registry](https://github.com/mcp/com.tallyfy/mcp-server)\n- [Smithery](https://smithery.ai/server/@tallyfy-inc/mcp-server)\n- [Glama](https://glama.ai/mcp/connectors/com.tallyfy/mcp-server)\n- [PulseMCP](https://www.pulsemcp.com/servers/tallyfy)\n\n## Security\n\nTools are scoped to the authenticated user, inputs are validated and the outbound API surface is allowlisted. We disclose no static credentials in this repository: all secrets are supplied at runtime via environment variables. If you find a security issue, please email **security@tallyfy.com** rather than opening a public issue.\n\n## Support\n\n- Product docs: https://tallyfy.com/products/pro/integrations/mcp-server/\n- Help / contact: https://tallyfy.com/contact/\n\n## License\n\n[Apache License 2.0](./LICENSE) © Tallyfy, Inc.\n",
  "bytes": 5623,
  "sha": "fd6eeef93c39ddaf071fd5504265953759d606209100f7d4272f6ecddb1e8670",
  "repo_slug": "tallyfy/mcp-public",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_tallyfy_mcp_server_bceba206/readme"
}