Agent Integration
MCP tool definitions, scopes, and parameters for AI agent clients.
Connection
Point your MCP client at https://getpidge.com/mcp
Auth: OAuth 2.1 with Google SSO bridge. Protocol: MCP over HTTP (Streamable HTTP transport). Machine-readable references are published at https://getpidge.com/agents.md and https://getpidge.com/llms.txt.
Tools
memory_search
Search business memory using natural language and return follow-up IDs.
Scope: read:memory
Params: { query: string, limit?: number }
memory_read
Read a specific memory entry by ID from memory_search results.
Scope: read:memory
Params: { id: string }
memory_daily
Read daily log entries by date or range.
Scope: read:memory
Params: { date?: string, days?: number }
memory_pinned
List pinned facts and long-lived knowledge.
Scope: read:memory
Params: { category?: string }
memory_remember
Pin a new fact to persistent memory.
Scope: write:memory
Params: { content: string, category?: string }
search
Run hybrid keyword and semantic search across indexed content.
Scope: read:search
Params: { query: string, limit?: number, scope?: "all"|"memory"|"files"|"packs" }
files_list
List files in the virtual filesystem.
Scope: read:files
Params: { path?: string, recursive?: boolean }
files_read
Read file contents from the virtual filesystem.
Scope: read:files
Params: { path: string }
files_write
Write or overwrite a file in the virtual filesystem.
Scope: write:files
Params: { path: string, content: string }
packs_list
List installed packs or browse the public Pidge marketplace.
Scope: read:packs
Params: { source?: "installed"|"marketplace", query?: string, category?: string, tag?: string, limit?: number, offset?: number }
packs_read
Read a specific installed pack or marketplace pack in detail.
Scope: read:packs
Params: { name: string, source?: "installed"|"marketplace" }
tasks_list
List tasks with optional status filtering.
Scope: read:tasks
Params: { status?: "pending"|"running"|"completed"|"failed", limit?: number }
task_start
Start a new background task from a natural-language instruction.
Scope: write:tasks
Params: { instruction: string, priority?: "low"|"normal"|"high" }
Scopes
read:memoryRead daily logs, pinned facts, search memorywrite:memoryCreate/update pinned facts, add daily entriesread:packsList and read installed packs and marketplace packsread:filesList and read virtual filesystemwrite:filesWrite/delete files in virtual filesystemread:searchFull-text and semantic searchread:tasksList and check task statuswrite:tasksStart new tasksLaunch Contract
Phase 39 launch contract is tools-only. MCP resources and prompts are not part of the supported public surface.
Use the documented tools instead of MCP resources or prompts at launch.
Rate Limits
60 req/min per user on MCP routes. The worker returns 429 with a Retry-After header when the limit is exceeded.