> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ocoya.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tools

> Overview of all Ocoya MCP tools.

# MCP Tools

Ocoya exposes 23 MCP tools. MCP clients call these tools through the standard `tools/call` JSON-RPC method, but most clients handle this automatically when you ask for an Ocoya action in natural language.

```json theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "ocoya_list_workspaces",
    "arguments": {}
  }
}
```

## Tool Categories

| Category                           | Tools                                                                                                                                                                                                                       | Typical use                                                                          |
| ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
| Account and workspace              | `ocoya_get_me`, `ocoya_list_workspaces`, `ocoya_get_workspace`                                                                                                                                                              | Resolve the authorized user and workspace IDs.                                       |
| Social profiles                    | `ocoya_list_social_profiles`, `ocoya_get_social_connection_url`, `ocoya_get_social_profile`                                                                                                                                 | Connect channels and choose where posts should be published.                         |
| Posts                              | `ocoya_list_posts`, `ocoya_list_calendar_posts`, `ocoya_get_post`, `ocoya_preview_post`, `ocoya_update_post`, `ocoya_create_post`, `ocoya_create_ai_post`, `ocoya_schedule_post`, `ocoya_publish_post`, `ocoya_delete_post` | Draft, generate with AI, inspect, schedule, publish, and remove posts.               |
| Brand, hashtag, and Studio context | `ocoya_list_brand_kits`, `ocoya_list_hashtag_libraries`, `ocoya_list_studio_templates`                                                                                                                                      | Find brand kit, hashtag library, and Studio design IDs to attach to generated posts. |
| Workflows                          | `ocoya_list_workflows`, `ocoya_get_workflow`, `ocoya_toggle_workflow`, `ocoya_run_workflow`                                                                                                                                 | Inspect, enable, disable, and run automations.                                       |

## Common Flow

<Steps>
  <Step title="Resolve the workspace">
    Use `ocoya_list_workspaces`, optionally with `query`, and keep the returned `id`.
  </Step>

  <Step title="Resolve social profiles">
    For posting tasks, call `ocoya_list_social_profiles` with `workspaceId` and keep the target profile IDs.
  </Step>

  <Step title="Create or inspect content">
    Use post tools with the resolved `workspaceId`, `socialProfileIds`, and any post or workflow IDs returned by list tools.
  </Step>
</Steps>

Use ISO datetimes for scheduling.

```txt theme={null}
2026-07-01T09:00:00Z
```

## Tool Reference

<CardGroup cols={2}>
  <Card title="ocoya_get_me" icon="user" href="/mcp/tools/ocoya-get-me">
    Get the Ocoya user associated with the MCP OAuth grant.
  </Card>

  <Card title="ocoya_list_workspaces" icon="building-2" href="/mcp/tools/ocoya-list-workspaces">
    List or search workspaces allowed by the MCP OAuth grant.
  </Card>

  <Card title="ocoya_get_social_connection_url" icon="link" href="/mcp/tools/ocoya-get-social-connection-url">
    Get a browser URL to connect a social network.
  </Card>

  <Card title="ocoya_create_post" icon="send" href="/mcp/tools/ocoya-create-post">
    Create a draft, scheduled post, or immediate publishing job.
  </Card>

  <Card title="ocoya_create_ai_post" icon="sparkles" href="/mcp/tools/ocoya-create-ai-post">
    Generate a ready-to-edit Ocoya draft post from a prompt using AI.
  </Card>

  <Card title="ocoya_list_hashtag_libraries" icon="hash" href="/mcp/tools/ocoya-list-hashtag-libraries">
    Find reusable hashtag library IDs for generated posts.
  </Card>

  <Card title="ocoya_list_studio_templates" icon="layout-template" href="/mcp/tools/ocoya-list-studio-templates">
    Find Studio design IDs for AI image references.
  </Card>

  <Card title="ocoya_run_workflow" icon="workflow" href="/mcp/tools/ocoya-run-workflow">
    Queue an Ocoya workflow run immediately.
  </Card>
</CardGroup>