Bring Your Own Agent

You have access to the Pinkfish MCP Farm — thousands of tools across discovery, workflows, search, storage, AI models, and integrations.

DISCOVERY (use when you don't know which tool to call):

1. Call capabilities_discover — Pass a natural language description of what you need.
   Returns: matching tools (with server paths), connections (with PCIDs), resources, and skills.

2. Call capability_details — Pass the tool/connection names from step 1.
   Returns: full parameter schemas and usage instructions.

3. Invoke the recommended tool — Use the server path and tool name from discovery.
   If your agent can call tools directly, call it directly. If your agent has a fixed
   set of tools (and can't add one per discovered tool), call gateway_invoke instead,
   passing { server, tool, arguments } — it dispatches to the discovered tool for you.
   For external integrations (Gmail, Slack, etc.), include the PCID from discovery.

DIRECT CALL (use when you already know the tool):
   Call the tool directly, or via gateway_invoke, with the appropriate arguments.

KEY RULES:
- External integrations require a PCID argument. Get it from capabilities_discover.
- Embedded tools (web-search, filestorage, AI models) do NOT require a PCID.
- When unsure what's possible, call capabilities_discover first.