Skip to main content
Both tools live on /pinkfish-sidekick. For full parameter schemas, see the Pinkfish Workflow Building server reference.
  1. capabilities_discover — Describe the task; get tools and connections
  2. capability_details — Pass tool names; get full parameter schemas

​
Discover Capabilities

curl -s -X POST "https://mcp.app.pinkfish.ai/pinkfish-sidekick" \
  -H "Authorization: Bearer $PINKFISH_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "capabilities_discover",
      "arguments": {
        "request": "search my gmail for unread emails"
      }
    },
    "id": 1
  }'
Parameters:
ParameterRequiredDescription
requestYesNatural language description of the task
typesNoFilter results: ["tool"], ["connection"], ["resource"], ["agentSkill"], or combinations
contextNo"workflow-creation" or "agent-execution" — filters available skills
Response: 
{
  "tools": [
    {
      "name": "gmail_search_emails",
      "serverName": "gmail",
      "hasSkill": false,
      "confidence": 0.95
    }
  ],
  "connections": [
    {
      "name": "My Gmail",
      "id": "abc123-pcid",
      "application": "gmail",
      "confidence": 0.95
    }
  ],
  "resources": [],
  "skills": []
}
FieldUse
tools[].nameTool name for tools/call
tools[].serverNameServer path (e.g. gmail → /gmail)
connections[].idPCID for application tools

​
Get Full Details

curl -s -X POST "https://mcp.app.pinkfish.ai/pinkfish-sidekick" \
  -H "Authorization: Bearer $PINKFISH_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "capability_details",
      "arguments": {
        "items": ["gmail_search_emails"]
      }
    },
    "id": 1
  }'
Parameters:
ParameterRequiredDescription
itemsYesTool names from discovery (use tools[].name, not serverName)
typesNoFilter: ["tool"], ["connection"], ["resource"], ["agentSkill"]

​
Flow

1. capabilities_discover("search my gmail for unread emails")
   → tools: [gmail_search_emails], connections: [My Gmail (PCID: abc123)]

2. capability_details(items: ["gmail_search_emails"])
   → Full inputSchema

3. tools/call with PCID from step 1