TOCA MCP Server
TOCA MCP Server
由 Google Drive 中的 TOCA_OS 业务事实来源治理的 ChatGPT 确定性执行层。
生产状态
该仓库已超越引导阶段。目前的生产基础包括:
位于
/mcp的私有 Streamable HTTP MCP 传输;健康检查/就绪边界;
Meta OAuth、webhook 与密钥管理边界;
由提供商支撑的 Instagram 历史记录/洞察读取;
Meta Ads 读取能力;
持久化 PostgreSQL 调度;
TOCA 管理的 Instagram 调度工具;
一个从 PostgreSQL 认领到期作业的自主单例 Cloud Run 守护进程;
幂等的 Instagram 发布,并在重试前进行由提供商支撑的对账;
通过短期签名 URL 交付私有 GCS 资产;
审计、死信与失败关闭(fail-closed)执行控制。
TOCA_OS / Google Drive 仍是业务事实来源。GitHub 是代码、模式、测试和基础设施的事实来源。外部提供商对外部副作用仍保持权威。
Related MCP server: genpark-workplace-goal-to-artifact-dag-orchestrator-skill
当前生产拓扑
ChatGPT
-> TOCA_OS business policy/context
-> private TOCA MCP service
-> typed MCP tools
-> PostgreSQL scheduled_jobs / audit_events / provider_publications
-> TOCA-managed Instagram daemon (singleton Cloud Run service)
-> claimDue()
-> approval/audit gate
-> provider reconciliation
-> idempotent Instagram publication
-> provider confirmation调度属于应用层操作,必须使用受保护的 instagram.toca_schedule.* MCP 接口面。Git 提交和应用重新部署不是常规的发布时钟或调度 API。
质量门禁
每个被提升的变更都必须通过:
pnpm install --frozen-lockfile
pnpm format:check
pnpm architecture:check
pnpm lint
pnpm typecheck
pnpm test
pnpm build关于当前契约,请参阅 docs/architecture/README.md、docs/architecture/routes-capabilities-v1.md、
docs/architecture/toca-managed-instagram-scheduler-v1.md 和
docs/operations/infrastructure-control-plane.md。
Available Tools
12 toolstoca.approval.getGet TOCA ApprovalARead-onlyIdempotent
Read one ApprovalRecord owned by the authenticated requester.
Inputs: approvalId (required).
toca.approval.requestRequest TOCA ApprovalB
Create a formal ApprovalRecord bound to the exact typed execution payload and authenticated requester.
Inputs: payload (required), evidence (required), expiresAt (required), capabilityId (required), +1 more.
toca.audit.queryQuery TOCA AuditBRead-onlyIdempotent
Read immutable audit-ledger records by correlation inside the authenticated tenant boundary.
Inputs: correlationId (required), limit, executionId.
toca.capabilities.describeDescribe TOCA CapabilityARead-onlyIdempotent
Resolve aliases and return the canonical typed, policy and lifecycle contract for one capability.
Inputs: capabilityId (required).
toca.capabilities.searchSearch TOCA CapabilitiesBRead-onlyIdempotent
Search the canonical capability catalog without materializing one MCP tool per capability.
Inputs: limit, query, routeId, provider, +1 more.
toca.event.getGet TOCA EventRecordARead-onlyIdempotent
Read one canonical EventRecord inside the authenticated tenant boundary.
Inputs: eventId (required).
toca.executeExecute TOCA CapabilityC
Resolve identity, capability, typed schema, policy, risk, approval, idempotency, handler, provider read-back and audit before reporting success.
Inputs: payload (required), capabilityId (required), correlationId (required), approvalId.
toca.system.healthTOCA Core HealthARead-onlyIdempotent
Return deterministic TOCA Core MCP surface and persistence readiness metadata.
Inputs: no named parameters.
toca.verifyVerify TOCA ExecutionBRead-onlyIdempotent
Verify the immutable audit chain, exact execution descriptor and fresh provider state for side effects.
Inputs: result (required), payload (required), executionId (required), capabilityId (required), +1 more.
toca.workflow.advanceAdvance TOCA WorkflowD
Apply one explicit, evidence-bearing transition through the existing durable workflow engine.
toca.workflow.createCreate TOCA WorkflowBIdempotent
Create a durable tenant-scoped workflow using the existing workflow engine and transactional outbox.
Inputs: steps (required), routeId (required), definitionId (required), correlationId (required), +3 more.
toca.workflow.getGet TOCA WorkflowARead-onlyIdempotent
Read one durable workflow inside the authenticated tenant boundary.
Inputs: workflowId (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 12 tools
Most tools have clearly distinct purposes (e.g., toca.workflow.create vs toca.workflow.get vs toca.workflow.advance). The exception is toca.system.health versus toca.verify—both touch on readiness/state but from different angles. Minor overlap is acceptable.
All tool names follow a consistent pattern of 'toca.<domain>.<verb>' with clear verbs (get, create, advance, query) and nouns (capability, workflow, approval, audit, event). No mixing of styles or conventions.
12 tools is well within the ideal 3-15 range. Each tool covers a distinct operation across core domains (system, capabilities, workflows, approvals, audit, events), and the count feels appropriately scoped for the server's purpose.
The server covers key operations but has notable gaps: workflow lacks an update/abort/delete, approval only has create/get (no approve/deny), and there is no event publishing—only reading. The execute tool is comprehensive but may serve as a generic workaround, yet missing lifecycle operations could still cause agent failures in certain flows.
Maintenance
Related MCP Connectors
Instagram for AI agents: publish, read comments and DMs, insights, and engage from your account.
Agent-first social media publishing, scheduling, analytics, and unified inbox API + 16-tool MCP server across 18 social platforms (X, LinkedIn, Instagram, YouTube, TikTok, Threads, Bluesky, Reddit, Telegram, Discord, Mastodon, Facebook, Pinterest).
Publish and schedule Instagram posts, Reels and carousels from your AI assistant.
Create, schedule and publish Instagram and Facebook posts from Claude or ChatGPT.
Related MCP Servers
- AlicenseAqualityFmaintenanceEnables AI assistants to interact with Instagram by scraping profiles, posts, reels, DMs, and business insights through a robust, DOM-agnostic browser orchestration engine that bypasses Instagram's anti-automation measures.281Apache 2.0
- AlicenseNot gradedqualityBmaintenanceEnables agents to break high-level business objectives into dependency-ordered sub-task graphs and then directly generate the finished deliverables, such as financial spreadsheets, executive presentations, and analytical reports. It runs as a zero-dependency Python MCP server over JSON-RPC stdio, adding deterministic authorization, role-boundary validation, and telemetry.7MIT
- FlicenseNot gradedqualityCmaintenanceEnables AI clients to operate Instagram Business and Creator accounts through Meta's official API with OAuth 2.1 authentication, covering publishing images, carousels, reels and stories, content scheduling, comment moderation, Direct messaging, and account and media insights across multiple connected accounts. An optional read-only private-session reader exposes Direct inbox threads, and a webhook-backed archive accumulates conversation history that Meta's API cannot return on demand.-

chatgenius-mcpofficial
AlicenseBqualityCmaintenanceEnables MCP clients like Claude and Cursor to read and act on Instagram, Facebook, WhatsApp and SMS inboxes, contacts, appointments, flows, comment automation, Content Studio posts, market intel and a knowledge base through the ChatGenius REST API. Exposes 105 scope-capped tools, with destructive actions marked for client approval and idempotency keys guarding every write.105206 npmMIT