Pachca API Agent Toolkit
MCP server, skills, CLI and six-language SDKs that let AI coding agents work with the Pachca corporate messenger API.
- Source repo
- pachca/openapi
- Stars
- ★ 11
- Last updated
- 3d ago
- License
- MIT
- Primary language
- TypeScript
- FA score
- 59/100 · Major gaps
At a glance
- Works with
- Universal · cross-platformChatGPT · Codex · Claude Code · Claude.ai
- You'll need
- Typical use
- Developers using Claude Code or Cursor who want the agent to read and write Pachca messages, chats and users directly.
- Main limitation
- Every capability targets the Pachca corporate messenger; it has no value outside that platform.
- Source review
- 59/100 · Major gaps
What does this agent do, and when should you use it?
This is the official API toolkit repository for Pachca, a corporate messenger. The API is authored in TypeSpec, and from that single definition the project generates an OpenAPI spec, a CLI, SDKs in six languages, an n8n community node, an MCP server tool manifest, and agent-facing documentation and skills. The repository is not a standalone agent; it is the interface layer that agents such as Claude Code, Codex, VS Code and Cursor consume. Key deliverables include the hosted MCP server at https://mcp.pachca.com/mcp, the @pachca/cli package, nine hand-written skills plus plugins, TypeScript/Python/Go/Kotlin/Swift/C# SDKs, and an n8n node. Everything derives from the same OpenAPI spec, so endpoints, examples and docs stay aligned. Using it requires a Pachca personal access token or an OAuth login.
The repository treats packages/spec/typespec.tsp as the source of truth: tsp compile emits openapi.yaml, which fans out to the CLI (@pachca/cli commands and data), the generator (SDKs under sdk/ for six languages), generate-mcp (mcp-manifest.json consumed by mcp.pachca.com), generate-n8n (the n8n node), and the Next.js docs site that produces method pages, llms.txt, llms-full.txt, per-endpoint Markdown and a Postman collection. The CLI exposes every API method as a subcommand (e.g. pachca messages create --entity-id=123 --content="…") and ships an offline API reference through pachca api ls and --describe. The MCP server exposes tools per API method, gated by the employee's role, plan and token type, with per-method rules embedded in tool descriptions. Nine skills (such as pachca-messaging, pachca-search, pachca-watch-thread) are installed via npx skills add or a plugin and guide agents through multi-step tasks.
- Developers using Claude Code or Cursor who want the agent to read and write Pachca messages, chats and users directly.
- Automation engineers who want to orchestrate 100+ Pachca operations and a webhook trigger in n8n without code.
- Backend teams that need a typed Pachca client in TypeScript, Python, Go, Kotlin, Swift or C#.
- Teams calling the Pachca API from CI or scripts, using the CLI's four output formats and cursor pagination.
- Product or support teams that want an agent to complete multi-step tasks such as summarizing a long thread and setting reminders.
- API integrators who need a standard openapi.yaml plus Postman/Bruno collections for their own toolchain.
How do you install or deploy this agent?
Install the CLI and log in:
npm install -g @pachca/cli
pachca auth loginOr add the MCP server to Claude Code:
claude mcp add --transport http pachca https://mcp.pachca.com/mcpInstall the skills (requires Node.js 22.20 or newer):
npx skills add https://dev.pachca.com -g -a claude-code -yInstall the plugin in Claude Code:
claude plugin marketplace add pachca/openapi --sparse .claude-plugin plugins
claude plugin install pachca@pachcaCodex:
codex plugin marketplace add pachca/openapi --sparse .agents/plugins --sparse plugins/pachca
codex plugin add pachca@pachcaGitHub Copilot CLI and VS Code:
copilot plugin marketplace add pachca/openapi
copilot plugin install pachca@pachcaHow do you use this agent?
Run the CLI directly with npx:
npx @pachca/cli messages create --entity-id=123 --content="Привет!" --token $PACHCA_TOKENBrowse the built-in API reference in the terminal:
pachca api ls
pachca api POST /messages --describe
pachca api POST /messages -F 'message[entity_id]=123' -f 'message[content]=Привет'Use an SDK in your code:
import { PachcaClient } from "@pachca/sdk";
const pachca = new PachcaClient("YOUR_TOKEN");
const users = await pachca.users.listUsers();
await pachca.reactions.addReaction(messageId, { code: "👍" });Generate a client in your own project:
npx @pachca/generator --output ./generated --lang typescript,pythonInstall the n8n community node:
npm install n8n-nodes-pachcaWhat are this agent's strengths and limitations?
- A single TypeSpec source generates the OpenAPI spec, CLI, six SDKs, n8n node and MCP manifest, so interfaces and docs do not drift.
- Three layers — MCP server, CLI and skills — cover conversational agents, terminal scripts and code integration.
- The MCP server is published in the official registry as com.pachca/mcp and gates tool visibility by role, plan and token type.
- SDKs follow one pattern (PachcaClient(token) → client.service.method(request)) with idiomatic naming in each language.
- Agent-facing discovery files (llms.txt, llms-full.txt, per-page Markdown, skill.md) are served with CORS enabled.
- Every capability targets the Pachca corporate messenger; it has no value outside that platform.
- Installing skills requires Node.js 22.20 or newer and a separate npx skills add or plugin install step.
- The MCP server runs in Pachca's backend; the repository only contains the tool manifest and cannot deploy the server itself.
- If the plugin already bundled the skills, running npx skills afterwards creates duplicate copies.
- On Cursor, the plugin's server needs a personal token from the PACHCA_TOKEN environment variable, unlike the browser login elsewhere.
How does this agent compare with similar options?
Key facts side by side with the most closely related agents.
| Agent | Source review | Form / cost | Stars | Updated | Language | Full support on |
|---|---|---|---|---|---|---|
| Pachca API Agent Toolkit This agent | 59 · Major gaps | — | ★ 11 | 3d ago | TypeScript | ChatGPT · Codex · Claude Code · Claude.ai |
| Fusio | 52 · Major gaps | Self-hosted serviceFree + model costs | ★ 2.1k | 11d ago | PHP | ChatGPT |
| CC Workflow Studio | 50 · Major gaps | IDE extensionFree + model costs | ★ 5.5k | 3mo ago | TypeScript | ChatGPT · Codex · Claude Code |
| MobileBuildMCP | 49 · Major gaps | CLIFree | ★ 6.5k | 15d ago | TypeScript | Codex · Claude Code |
How does FollowAgents rate this agent?
Why each dimension lost points
README states MCP tools are scoped by employee role, plan and token type, and advises running `pachca auth login` in the user's own terminal rather than inside an agent command — positive signals for least privilege and sensitive credential handling, but they are prose claims with no code-level permission checks or confirmation flow shown, so least_privilege, user_confirmation and sensitive_data_handling each score 1. Data flow is described only at a high level (MCP server runs in Pachca's backend, skills use the CLI) with no retention or transport detail, score 1. Dependency security: package.json lists ordinary devDependencies and trustedDependencies but no audit or lockfile policy, score 1. External effects: the `pachca-watch-thread` skill runs a background script and calls the CLI, with no rollback or undo mechanism documented, so external_effects and rollback each score 1. Source attribution has a full MIT LICENSE naming Pachca, score 2; publisher identity is unverified by the FollowAgents registry and earns no extra credit.
The repo uses TypeSpec as a single source of truth to generate OpenAPI, SDKs, CLI and the n8n node, and check.yml enforces changelog sync, generated-file sync, docs formatting and markdown lint, giving strong self-consistency, score 2. Dependency availability: README shows npm/PyPI/NuGet/JitPack badges and install commands, so dependencies are publicly obtainable, score 2. Failure messages: only generic mentions of CLI validation and a skill covering 'missing permission or tool'; no concrete error codes or diagnostic output examples, score 1.
README clearly separates audiences and scenarios — MCP server, CLI, skills and plugin, SDKs, n8n — and lists Claude Code, Codex, VS Code, Cursor and Copilot clients, so audience_and_scenarios scores 3. Capability boundaries are fairly clear (skills are instructions only, except `pachca-watch-thread` which needs Node.js 22.20+ and a signed-in CLI), but unsupported capabilities are not systematically listed, score 2. Trigger precision: the agent is said to pick a skill automatically when a task matches, with explicit invocation like `/pachca-watch-thread`, but no trigger-condition detail, score 2. Environment fit covers many clients and six SDK languages, but some docs are Russian-only and the Node version requirement is recent, score 2.
Information architecture is clear, organized by MCP/CLI/skills/SDK/n8n/testing/AI integrations, score 3. Install notes are thorough with npx, global install, plugin marketplace commands and manual-install links, score 3. Naming stability: SDK naming rules are explicit (operationId prefix stripped, per-language style), but the n8n node carries V1/V2 compatibility maps and alias operations, showing a naming migration, score 2. Examples and FAQ: TypeScript and CLI examples exist, but no FAQ or troubleshooting section, score 2. Known limitations are only scattered (e.g. don't add skills twice when the plugin is installed) and not consolidated, score 1. License is full MIT text, score 3. Versioning/changelog: releases.json, docs/releases.md and a changelog-sync check exist, but no complete CHANGELOG file is in the provided files, score 2. Maintenance responsibility: only Issues and email addresses, no maintainer, SLA or deprecation policy, and the publisher is unverified, score 1.
Output usability: the CLI offers table/JSON/YAML/CSV output, pagination and `--describe`, and SDKs follow one call pattern, so outputs are directly usable, score 2. Marginal value: on top of an existing OpenAPI spec it adds MCP tools, skills and six SDKs, which is incremental value for agent scenarios but still fundamentally an API wrapper, score 2. Cost benefit: skills reduce context spend and the CLI's built-in API reference avoids opening the docs site, but Node.js 22.20+ and extra install steps add cost, score 2.
claim_traceability: most README claims map to repository files (LICENSE, package.json, workflows, test files), but claims about the MCP server running in the backend and skills published to dev.pachca.com cannot be checked in-repo, score 2. cross_source_corroboration: the n8n test files corroborate README statements about V1/V2 compatibility, pagination and credential testing, score 2. fact_inference_separation: README distinguishes hand-written skills from generated artifacts, but some capability claims (e.g. the agent auto-selecting skills) are inferential and not marked as such, score 1.
- The MCP server runs in Pachca's backend; its permission scoping, data retention and transport security cannot be verified from this repository and need independent assessment before deployment.
- The `pachca-watch-thread` skill runs a background Node.js script and calls the CLI; confirm where its credentials come from and how they can be revoked.
- Publisher identity is unverified by the FollowAgents registry; verify source and signatures before installing the plugin or skills.
- Some documentation is Russian-only, so English users may miss key install and limitation notes.
- The n8n node carries V1/V2 compatibility maps and alias operations; watch for parameter renames when upgrading.