MCP Tools Overview

Coconut exposes 11 tools through the Model Context Protocol. Claude Code can call these tools directly to manage your content workflow.

Tool Categories

Workspace

Get workspace stats and plan limits

Creators

Look up and subscribe to creators

Ingestion

Trigger and monitor content fetching

Digest

Review and curate content

Analysis

AI-powered content analysis

Blocks

Create and manage your content

All Tools

Tool	Description
workspace_stats	Get workspace overview, stats, and plan limits
creator_lookup	Look up a creator by platform and handle
subscription_create	Subscribe to a creator
subscription_list	List all subscriptions
ingestion_trigger	Trigger content ingestion
ingestion_status	Check ingestion job status
digest_list	Get unactioned content
digest_action	Record action on digest item
content_analyze	AI-analyze a piece of content
block_create	Create a content block
block_list	List content blocks

Common Patterns

Supported Platforms

All tools that accept a platform parameter support:

x - X (Twitter)
instagram - Instagram
tiktok - TikTok
youtube - YouTube
linkedin - LinkedIn

Pagination

Tools that return lists support pagination:

{
  "limit": 20,    // Items per page (1-100, default varies)
  "offset": 0     // Items to skip
}

Response includes pagination metadata:

{
  "pagination": {
    "total": 150,
    "limit": 20,
    "offset": 0,
    "hasMore": true
  }
}

Error Responses

All tools return errors in a consistent format:

{
  "error": {
    "code": "not_found",
    "message": "Creator not found",
    "suggestion": "Check the handle spelling"
  }
}

Common error codes:

Code	Meaning
`not_found`	Resource doesn't exist
`already_exists`	Duplicate resource
`limit_exceeded`	Plan limit reached
`service_error`	Internal service failure
`internal_error`	Unexpected error

Typical Workflow

Start

Check workspace_stats to see your limits

Use creator_lookup + subscription_create for new creators

Ingest

Trigger ingestion_trigger, check with ingestion_status

Review

Browse digest_list, take actions with digest_action

Create

Use content_analyze to learn, then block_create to draft