Wobaka MCP by usefulapi

Read contacts, tasks and pipelines; create contacts, tasks, notes and opportunities in Wobaka.

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
77%
Naming quality
80%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~3,013Tokens (tool definitions)
~1.5 KBTypical response size
Significant attention impact (2.35% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "wobaka": {
      "url": "https://wobaka.usefulapi.io/mcp"
    }
  }
}

Remote endpoints

https://wobaka.usefulapi.io/mcpstreamable-http

What it can do

Tool inventory

Tools (16)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢wobaka_list_contacts(query, statuses, users, tags, is_company, ...)

List active contacts (or archived ones with show_archived). Filter by search text, status, owner, tags, or company vs person. Wobaka API: GET /contacts.

Input Schema

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Case-insensitive search across contact fields and custom attributes.",
      "type": "string"
    },
    "statuses": {
      "description": "Only contacts with these status ids (from wobaka_list_statuses).",
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "users": {
      "description": "Only contacts owned by these member ids (from wobaka_list_members).",
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "tags": {
      "description": "Only contacts that have all these tags.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "is_company": {
      "description": "true for company contacts, false for person contacts.",
      "type": "boolean"
    },
    "show_archived": {
      "description": "true returns archived contacts instead of active ones.",
      "type": "boolean"
    },
    "order_by": {
      "description": "Sort field (default created-at).",
      "type": "string",
      "enum": [
        "created-at",
        "email",
        "first-name",
        "company",
        "status-name",
        "archived-at",
        "last-activity-at"
      ]
    },
    "order_direction": {
      "description": "Sort direction.",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "limit": {
      "description": "Results per page, 1 to 100 (default 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "skip": {
      "description": "Number of matching records to skip (default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢wobaka_get_contact(contact_id)

Show one contact with its custom attributes and related contacts. Wobaka API: GET /contacts/:id.

Input Schema

{
  "type": "object",
  "properties": {
    "contact_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Numeric Wobaka id."
    }
  },
  "required": [
    "contact_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢wobaka_get_contact_feed(contact_id)

Show the timeline of one contact: notes, messages, emails, automation messages and actions, each with a type field. Wobaka API: GET /contacts/:id/feed.

Input Schema

{
  "type": "object",
  "properties": {
    "contact_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Numeric Wobaka id."
    }
  },
  "required": [
    "contact_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢wobaka_list_contact_notes(contact_id)

List all notes on one contact, oldest first (not paginated). Wobaka API: GET /contacts/:id/notes.

Input Schema

{
  "type": "object",
  "properties": {
    "contact_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Numeric Wobaka id."
    }
  },
  "required": [
    "contact_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢wobaka_list_tasks(query, show_done, users, order_by, order_direction, ...)

List open tasks (or completed ones with show_done) across the company. Filter by assignee or search text. Wobaka API: GET /tasks.

Input Schema

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Case-insensitive search over task description, note, and contact details.",
      "type": "string"
    },
    "show_done": {
      "description": "true returns completed tasks instead of open ones.",
      "type": "boolean"
    },
    "users": {
      "description": "Only tasks assigned to these member ids.",
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "order_by": {
      "description": "Property to sort by, such as due-at or created-at. Needs order_direction.",
      "type": "string"
    },
    "order_direction": {
      "description": "Sort direction.",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "limit": {
      "description": "Results per page, 1 to 100 (default 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "skip": {
      "description": "Number of matching records to skip (default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢wobaka_list_contact_tasks(contact_id)

List all tasks for one contact, newest first (not paginated). Wobaka API: GET /contacts/:id/tasks.

Input Schema

{
  "type": "object",
  "properties": {
    "contact_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Numeric Wobaka id."
    }
  },
  "required": [
    "contact_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢wobaka_get_company

Show the company name and id of the account this key belongs to. Wobaka API: GET /company.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢wobaka_list_members

List the company members (active and inactive) with their ids, for owner and assignee fields (not paginated). Wobaka API: GET /members.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢wobaka_list_statuses

List the contact statuses in display order, for status_id fields (not paginated). Wobaka API: GET /statuses.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢wobaka_list_pipelines

List the sales pipelines with their stages in order (not paginated). Use a stage id, not a pipeline id, when creating an opportunity. Wobaka API: GET /pipelines.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴wobaka_create_contact(first_name, last_name, email, company, phone, ...)

Create a contact owned by the key's user. A person contact needs a first name, last name, email, or company; a company contact needs company. Wobaka API: POST /contacts.

Input Schema

{
  "type": "object",
  "properties": {
    "first_name": {
      "type": "string"
    },
    "last_name": {
      "type": "string"
    },
    "email": {
      "description": "Normalized to lowercase by Wobaka.",
      "type": "string"
    },
    "company": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "address": {
      "type": "string"
    },
    "website": {
      "type": "string"
    },
    "description": {
      "description": "Short description of the contact.",
      "type": "string"
    },
    "status_id": {
      "description": "Status id from wobaka_list_statuses; default if omitted.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "is_company": {
      "type": "boolean"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "attributes": {
      "description": "Custom contact properties. At most 50 keys.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": [
          "string",
          "number",
          "boolean",
          "null"
        ]
      }
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟡wobaka_update_contact(contact_id, first_name, last_name, email, company, ...)

Change the given fields of one contact. The tool reads the contact first and keeps every field you do not pass, because Wobaka replaces the whole contact on update. Wobaka API: GET then PUT /contacts/:id.

Input Schema

{
  "type": "object",
  "properties": {
    "contact_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Numeric Wobaka id."
    },
    "first_name": {
      "type": "string"
    },
    "last_name": {
      "type": "string"
    },
    "email": {
      "type": "string"
    },
    "company": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "address": {
      "type": "string"
    },
    "website": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "status_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "tags": {
      "description": "Replaces the tag list.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "attributes": {
      "description": "Custom contact properties. At most 50 keys.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": [
          "string",
          "number",
          "boolean",
          "null"
        ]
      }
    }
  },
  "required": [
    "contact_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴wobaka_create_task(description, note, assigned_to, contact_id, due_at)

Create a task assigned to a company member, optionally linked to a contact. Wobaka API: POST /tasks.

Input Schema

{
  "type": "object",
  "properties": {
    "description": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "description": "Task text, up to 255 characters."
    },
    "note": {
      "description": "Extra notes, up to 1000 characters.",
      "type": "string",
      "maxLength": 1000
    },
    "assigned_to": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Member id from wobaka_list_members."
    },
    "contact_id": {
      "description": "Related contact id; a task may have none.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "due_at": {
      "type": "string",
      "description": "Due date as YYYY-MM-DD or an ISO 8601 UTC timestamp, for example 2026-12-01 or 2026-12-01T09:00:00Z."
    }
  },
  "required": [
    "description",
    "assigned_to"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴wobaka_create_note(contact_id, body)

Add a note to one contact; the author and timestamps are set by Wobaka. Wobaka API: POST /notes.

Input Schema

{
  "type": "object",
  "properties": {
    "contact_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Numeric Wobaka id."
    },
    "body": {
      "type": "string",
      "minLength": 1,
      "description": "Note text. Cannot be empty."
    }
  },
  "required": [
    "contact_id",
    "body"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴wobaka_create_opportunity(contact_id, stage_id, user_id, name, description, ...)

Create a sales opportunity on a contact in a pipeline stage. The contact, stage and assignee must belong to the company. Wobaka API: POST /opportunities.

Input Schema

{
  "type": "object",
  "properties": {
    "contact_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Numeric Wobaka id."
    },
    "stage_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Stage id from wobaka_list_pipelines (not the pipeline id)."
    },
    "user_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Assignee member id from wobaka_list_members."
    },
    "name": {
      "type": "string",
      "minLength": 1
    },
    "description": {
      "type": "string"
    },
    "value_amount": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "Whole currency units; 0 when there is no value."
    },
    "value_currency": {
      "type": "string",
      "description": "Lowercase currency, for example usd, euro, or gbp."
    },
    "value_interval": {
      "type": "string",
      "enum": [
        "annual",
        "monthly",
        "one-time"
      ]
    }
  },
  "required": [
    "contact_id",
    "stage_id",
    "user_id",
    "name",
    "value_amount",
    "value_currency",
    "value_interval"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟡wobaka_update_opportunity(opportunity_id, stage_id, user_id, name, description, ...)

Change the given fields of one opportunity (for example move it to another stage). Fields you do not pass are kept. Set archived_at to mark it lost; set it to null to restore it. Wobaka API: PUT /opportunities/:id.

Input Schema

{
  "type": "object",
  "properties": {
    "opportunity_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Numeric Wobaka id."
    },
    "stage_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "user_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "name": {
      "type": "string",
      "minLength": 1
    },
    "description": {
      "type": "string"
    },
    "value_amount": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "value_currency": {
      "type": "string"
    },
    "value_interval": {
      "type": "string",
      "enum": [
        "annual",
        "monthly",
        "one-time"
      ]
    },
    "archived_at": {
      "description": "UTC ISO 8601 timestamp to mark lost, or null to restore.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "opportunity_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded16 tools