_ registry / mcp streamable-http · checked 16h ago

twenty-mcp

https://twenty.usefulapi.io

Registry code: b65877c5edd02655

api record

Read people, companies, opportunities, notes and tasks; create and update records in Twenty CRM.

from a public catalogue that lists it, not from the operator

endpoint
https://twenty.usefulapi.io/mcp
protocol
streamable-http ·2025-06-18
authentication
none observed
public key
none — nobody has proven they own this listing
karma
0 · newcomer
reachable
live
uptime, 30 days
100%

90 days 100%· all time 100%

latency
281ms

last good check

priced tools
0

of 20 tools

_ answered our checks, 90 days 1 checks · signed record
  • unknown → live
_ used through this hub 30 days

The one measurement on this page that an operator cannot produce by editing a file on its own server: somebody else chose it, and paid to. Read the accounts before the calls — volume from one account is one relationship, and calling yourself is the cheap half. Both are what the ranking is built from, printed so the order can be checked rather than taken on trust.

accounts
0

distinct, expensive to fake

calls served
0

successful, last 30 days

_ what it can do 20 tools
20 auth-required 20 of 20 classified

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

  • twenty_get_company auth-required never probed

    Get a single company by id. Twenty REST: GET /rest/companies/{id}.

    mcp-tool

    {
      "type": "object",
      "$schema": "http://json-schema.org/draft-07/schema#",
      "required": [
        "id"
      ],
      "properties": {
        "id": {
          "type": "string",
          "description": "The company id."
        },
        "depth": {
          "type": "integer",
          "maximum": 2,
          "minimum": 0,
          "description": "How deep to hydrate related records: 0, 1, or 2."
        }
      }
    }
    arguments 19 lines
  • twenty_list_companies auth-required 16h ago

    List/filter companies. Supports cursor pagination, raw filter/order_by, and relation depth. Twenty REST: GET /rest/companies.

    mcp-tool

    {
      "type": "object",
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "depth": {
          "type": "integer",
          "maximum": 2,
          "minimum": 0,
          "description": "How deep to hydrate related records: 0, 1, or 2."
        },
        "limit": {
          "type": "integer",
          "maximum": 60,
          "minimum": 1,
          "description": "Results per page (1-60, default 20 — Twenty caps at 60)."
        },
        "filter": {
          "type": "string",
          "description": "Raw Twenty filter string, passed verbatim as ?filter=. Syntax: field[comparator]:value, e.g. `employees[gte]:100` or `stage[eq]:\"MEETING\"`. Comparators: eq, neq, gt, gte, lt, lte, in, is, like, ilike, startsWith."
        },
        "order_by": {
          "type": "string",
          "description": "Raw Twenty ordering string, passed verbatim as ?order_by=, e.g. `createdAt[DescNullsLast]`."
        },
        "ending_before": {
          "type": "string",
          "description": "Pagination cursor — return records before this cursor (from a previous page's pageInfo)."
        },
        "starting_after": {
          "type": "string",
          "description": "Pagination cursor — return records after this cursor (from a previous page's pageInfo)."
        }
      }
    }
    arguments 34 lines
  • twenty_list_metadata_objects auth-required 16h ago

    List all objects (standard + custom) and their fields from the Twenty schema — use this to discover custom objects/fields and valid field names. Twenty REST: GET /rest/metadata/objects.

    mcp-tool

    {
      "type": "object",
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {}
    }
    arguments 5 lines
  • twenty_list_notes auth-required 16h ago

    List/filter notes. Supports cursor pagination, raw filter/order_by, and relation depth. Twenty REST: GET /rest/notes.

    mcp-tool

    {
      "type": "object",
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "depth": {
          "type": "integer",
          "maximum": 2,
          "minimum": 0,
          "description": "How deep to hydrate related records: 0, 1, or 2."
        },
        "limit": {
          "type": "integer",
          "maximum": 60,
          "minimum": 1,
          "description": "Results per page (1-60, default 20 — Twenty caps at 60)."
        },
        "filter": {
          "type": "string",
          "description": "Raw Twenty filter string, passed verbatim as ?filter=. Syntax: field[comparator]:value, e.g. `employees[gte]:100` or `stage[eq]:\"MEETING\"`. Comparators: eq, neq, gt, gte, lt, lte, in, is, like, ilike, startsWith."
        },
        "order_by": {
          "type": "string",
          "description": "Raw Twenty ordering string, passed verbatim as ?order_by=, e.g. `createdAt[DescNullsLast]`."
        },
        "ending_before": {
          "type": "string",
          "description": "Pagination cursor — return records before this cursor (from a previous page's pageInfo)."
        },
        "starting_after": {
          "type": "string",
          "description": "Pagination cursor — return records after this cursor (from a previous page's pageInfo)."
        }
      }
    }
    arguments 34 lines
  • twenty_update_person auth-required never probed

    Update fields on an existing person. Only provided fields change. Twenty REST: PATCH /rest/people/{id}.

    mcp-tool

    {
      "type": "object",
      "$schema": "http://json-schema.org/draft-07/schema#",
      "required": [
        "id"
      ],
      "properties": {
        "id": {
          "type": "string",
          "description": "The person id to update."
        },
        "city": {
          "type": "string",
          "description": "City."
        },
        "xUrl": {
          "type": "string",
          "description": "X/Twitter URL (sent as xLink:{primaryLinkUrl})."
        },
        "extra": {
          "type": "object",
          "description": "Passthrough object of additional/custom fields merged into the request body verbatim.",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        },
        "jobTitle": {
          "type": "string",
          "description": "Job title."
        },
        "lastName": {
          "type": "string",
          "description": "Last name (combined into name:{firstName,lastName})."
        },
        "companyId": {
          "type": "string",
          "description": "Id of the company to link this person to."
        },
        "firstName": {
          "type": "string",
          "description": "First name (combined into name:{firstName,lastName})."
        },
        "linkedinUrl": {
          "type": "string",
          "description": "LinkedIn URL (sent as linkedinLink:{primaryLinkUrl})."
        },
        "primaryEmail": {
          "type": "string",
          "description": "Primary email address (sent as emails:{primaryEmail})."
        },
        "primaryPhone": {
          "type": "string",
          "description": "Primary phone number (sent as phones:{primaryPhoneNumber})."
        }
      }
    }
    arguments 57 lines
  • twenty_create_company auth-required never probed

    Create a new company. `name` is required. Twenty REST: POST /rest/companies.

    mcp-tool

    {
      "type": "object",
      "$schema": "http://json-schema.org/draft-07/schema#",
      "required": [
        "name"
      ],
      "properties": {
        "name": {
          "type": "string",
          "description": "The company name (required)."
        },
        "xUrl": {
          "type": "string",
          "description": "X/Twitter URL (sent as xLink:{primaryLinkUrl})."
        },
        "extra": {
          "type": "object",
          "description": "Passthrough object of additional/custom fields merged into the request body verbatim.",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        },
        "employees": {
          "type": "number",
          "description": "Employee count."
        },
        "domainName": {
          "type": "string",
          "description": "Primary domain / website URL (sent as domainName:{primaryLinkUrl})."
        },
        "addressCity": {
          "type": "string",
          "description": "City (sent as address:{addressCity})."
        },
        "linkedinUrl": {
          "type": "string",
          "description": "LinkedIn URL (sent as linkedinLink:{primaryLinkUrl})."
        },
        "idealCustomerProfile": {
          "type": "boolean",
          "description": "Whether this company matches the ideal customer profile."
        }
      }
    }
    arguments 45 lines
  • twenty_update_company auth-required never probed

    Update fields on an existing company. Only provided fields change. Twenty REST: PATCH /rest/companies/{id}.

    mcp-tool

    {
      "type": "object",
      "$schema": "http://json-schema.org/draft-07/schema#",
      "required": [
        "id"
      ],
      "properties": {
        "id": {
          "type": "string",
          "description": "The company id to update."
        },
        "name": {
          "type": "string",
          "description": "The company name."
        },
        "xUrl": {
          "type": "string",
          "description": "X/Twitter URL (sent as xLink:{primaryLinkUrl})."
        },
        "extra": {
          "type": "object",
          "description": "Passthrough object of additional/custom fields merged into the request body verbatim.",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        },
        "employees": {
          "type": "number",
          "description": "Employee count."
        },
        "domainName": {
          "type": "string",
          "description": "Primary domain / website URL (sent as domainName:{primaryLinkUrl})."
        },
        "addressCity": {
          "type": "string",
          "description": "City (sent as address:{addressCity})."
        },
        "linkedinUrl": {
          "type": "string",
          "description": "LinkedIn URL (sent as linkedinLink:{primaryLinkUrl})."
        },
        "idealCustomerProfile": {
          "type": "boolean",
          "description": "Whether this company matches the ideal customer profile."
        }
      }
    }
    arguments 49 lines
  • twenty_create_opportunity auth-required never probed

    Create a new opportunity (deal). `name` is required; amountMicros combines with currencyCode into amount:{amountMicros,currencyCode}. Twenty REST: POST /rest/opportunities.

    mcp-tool

    {
      "type": "object",
      "$schema": "http://json-schema.org/draft-07/schema#",
      "required": [
        "name"
      ],
      "properties": {
        "name": {
          "type": "string",
          "description": "The opportunity name (required)."
        },
        "extra": {
          "type": "object",
          "description": "Passthrough object of additional/custom fields merged into the request body verbatim.",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        },
        "stage": {
          "type": "string",
          "description": "Pipeline stage — e.g. SCREENING, MEETING, PROPOSAL, NEGOTIATION, CUSTOMER (custom pipelines vary)."
        },
        "closeDate": {
          "type": "string",
          "description": "Expected close date (ISO 8601)."
        },
        "companyId": {
          "type": "string",
          "description": "Id of the associated company."
        },
        "amountMicros": {
          "type": "number",
          "description": "Opportunity amount in micros (× 1,000,000). Sent as amount:{amountMicros,currencyCode}."
        },
        "currencyCode": {
          "type": "string",
          "default": "USD",
          "description": "Currency code for the amount (default USD; only sent when amountMicros is provided)."
        },
        "pointOfContactId": {
          "type": "string",
          "description": "Id of the point-of-contact person."
        }
      }
    }
    arguments 46 lines
  • twenty_update_opportunity auth-required never probed

    Update fields on an existing opportunity. Only provided fields change. Twenty REST: PATCH /rest/opportunities/{id}.

    mcp-tool

    {
      "type": "object",
      "$schema": "http://json-schema.org/draft-07/schema#",
      "required": [
        "id"
      ],
      "properties": {
        "id": {
          "type": "string",
          "description": "The opportunity id to update."
        },
        "name": {
          "type": "string",
          "description": "The opportunity name."
        },
        "extra": {
          "type": "object",
          "description": "Passthrough object of additional/custom fields merged into the request body verbatim.",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        },
        "stage": {
          "type": "string",
          "description": "Pipeline stage — e.g. SCREENING, MEETING, PROPOSAL, NEGOTIATION, CUSTOMER (custom pipelines vary)."
        },
        "closeDate": {
          "type": "string",
          "description": "Expected close date (ISO 8601)."
        },
        "companyId": {
          "type": "string",
          "description": "Id of the associated company."
        },
        "amountMicros": {
          "type": "number",
          "description": "Opportunity amount in micros (× 1,000,000). Sent as amount:{amountMicros,currencyCode}."
        },
        "currencyCode": {
          "type": "string",
          "default": "USD",
          "description": "Currency code for the amount (default USD; only sent when amountMicros is provided)."
        },
        "pointOfContactId": {
          "type": "string",
          "description": "Id of the point-of-contact person."
        }
      }
    }
    arguments 50 lines
  • twenty_create_note auth-required never probed

    Create a note. `title` is required; `body` holds the note content. (Attaching to records via noteTargets is out of scope.) Twenty REST: POST /rest/notes.

    mcp-tool

    {
      "type": "object",
      "$schema": "http://json-schema.org/draft-07/schema#",
      "required": [
        "title"
      ],
      "properties": {
        "body": {
          "type": "string",
          "description": "The note content/body."
        },
        "extra": {
          "type": "object",
          "description": "Passthrough object of additional/custom fields merged into the request body verbatim.",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        },
        "title": {
          "type": "string",
          "description": "The note title (required)."
        }
      }
    }
    arguments 25 lines
  • twenty_create_task auth-required never probed

    Create a task. `title` is required. Twenty REST: POST /rest/tasks.

    mcp-tool

    {
      "type": "object",
      "$schema": "http://json-schema.org/draft-07/schema#",
      "required": [
        "title"
      ],
      "properties": {
        "body": {
          "type": "string",
          "description": "Task body / description."
        },
        "dueAt": {
          "type": "string",
          "description": "Due date/time (ISO 8601)."
        },
        "extra": {
          "type": "object",
          "description": "Passthrough object of additional/custom fields merged into the request body verbatim.",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        },
        "title": {
          "type": "string",
          "description": "The task title (required)."
        },
        "status": {
          "type": "string",
          "description": "Task status — e.g. TODO, IN_PROGRESS, DONE."
        },
        "assigneeId": {
          "type": "string",
          "description": "Id of the workspace member assigned to the task."
        }
      }
    }
    arguments 37 lines
  • twenty_get_opportunity auth-required never probed

    Get a single opportunity by id. Twenty REST: GET /rest/opportunities/{id}.

    mcp-tool

    {
      "type": "object",
      "$schema": "http://json-schema.org/draft-07/schema#",
      "required": [
        "id"
      ],
      "properties": {
        "id": {
          "type": "string",
          "description": "The opportunity id."
        },
        "depth": {
          "type": "integer",
          "maximum": 2,
          "minimum": 0,
          "description": "How deep to hydrate related records: 0, 1, or 2."
        }
      }
    }
    arguments 19 lines
  • twenty_get_note auth-required never probed

    Get a single note by id. Twenty REST: GET /rest/notes/{id}.

    mcp-tool

    {
      "type": "object",
      "$schema": "http://json-schema.org/draft-07/schema#",
      "required": [
        "id"
      ],
      "properties": {
        "id": {
          "type": "string",
          "description": "The note id."
        },
        "depth": {
          "type": "integer",
          "maximum": 2,
          "minimum": 0,
          "description": "How deep to hydrate related records: 0, 1, or 2."
        }
      }
    }
    arguments 19 lines
  • twenty_list_tasks auth-required never probed

    List/filter tasks. Supports cursor pagination, raw filter/order_by, and relation depth. Twenty REST: GET /rest/tasks.

    mcp-tool

    {
      "type": "object",
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "depth": {
          "type": "integer",
          "maximum": 2,
          "minimum": 0,
          "description": "How deep to hydrate related records: 0, 1, or 2."
        },
        "limit": {
          "type": "integer",
          "maximum": 60,
          "minimum": 1,
          "description": "Results per page (1-60, default 20 — Twenty caps at 60)."
        },
        "filter": {
          "type": "string",
          "description": "Raw Twenty filter string, passed verbatim as ?filter=. Syntax: field[comparator]:value, e.g. `employees[gte]:100` or `stage[eq]:\"MEETING\"`. Comparators: eq, neq, gt, gte, lt, lte, in, is, like, ilike, startsWith."
        },
        "order_by": {
          "type": "string",
          "description": "Raw Twenty ordering string, passed verbatim as ?order_by=, e.g. `createdAt[DescNullsLast]`."
        },
        "ending_before": {
          "type": "string",
          "description": "Pagination cursor — return records before this cursor (from a previous page's pageInfo)."
        },
        "starting_after": {
          "type": "string",
          "description": "Pagination cursor — return records after this cursor (from a previous page's pageInfo)."
        }
      }
    }
    arguments 34 lines
  • twenty_get_task auth-required never probed

    Get a single task by id. Twenty REST: GET /rest/tasks/{id}.

    mcp-tool

    {
      "type": "object",
      "$schema": "http://json-schema.org/draft-07/schema#",
      "required": [
        "id"
      ],
      "properties": {
        "id": {
          "type": "string",
          "description": "The task id."
        },
        "depth": {
          "type": "integer",
          "maximum": 2,
          "minimum": 0,
          "description": "How deep to hydrate related records: 0, 1, or 2."
        }
      }
    }
    arguments 19 lines
  • twenty_create_person auth-required never probed

    Create a new person (contact). All fields optional; firstName/lastName combine into name:{firstName,lastName}. Twenty REST: POST /rest/people.

    mcp-tool

    {
      "type": "object",
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "city": {
          "type": "string",
          "description": "City."
        },
        "xUrl": {
          "type": "string",
          "description": "X/Twitter URL (sent as xLink:{primaryLinkUrl})."
        },
        "extra": {
          "type": "object",
          "description": "Passthrough object of additional/custom fields merged into the request body verbatim.",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        },
        "jobTitle": {
          "type": "string",
          "description": "Job title."
        },
        "lastName": {
          "type": "string",
          "description": "Last name (combined into name:{firstName,lastName})."
        },
        "companyId": {
          "type": "string",
          "description": "Id of the company to link this person to."
        },
        "firstName": {
          "type": "string",
          "description": "First name (combined into name:{firstName,lastName})."
        },
        "linkedinUrl": {
          "type": "string",
          "description": "LinkedIn URL (sent as linkedinLink:{primaryLinkUrl})."
        },
        "primaryEmail": {
          "type": "string",
          "description": "Primary email address (sent as emails:{primaryEmail})."
        },
        "primaryPhone": {
          "type": "string",
          "description": "Primary phone number (sent as phones:{primaryPhoneNumber})."
        }
      }
    }
    arguments 50 lines
  • twenty_update_task auth-required never probed

    Update fields on an existing task. Only provided fields change. Twenty REST: PATCH /rest/tasks/{id}.

    mcp-tool

    {
      "type": "object",
      "$schema": "http://json-schema.org/draft-07/schema#",
      "required": [
        "id"
      ],
      "properties": {
        "id": {
          "type": "string",
          "description": "The task id to update."
        },
        "body": {
          "type": "string",
          "description": "Task body / description."
        },
        "dueAt": {
          "type": "string",
          "description": "Due date/time (ISO 8601)."
        },
        "extra": {
          "type": "object",
          "description": "Passthrough object of additional/custom fields merged into the request body verbatim.",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        },
        "title": {
          "type": "string",
          "description": "The task title."
        },
        "status": {
          "type": "string",
          "description": "Task status — e.g. TODO, IN_PROGRESS, DONE."
        },
        "assigneeId": {
          "type": "string",
          "description": "Id of the workspace member assigned to the task."
        }
      }
    }
    arguments 41 lines
  • twenty_get_person auth-required never probed

    Get a single person (contact) by id. Twenty REST: GET /rest/people/{id}.

    mcp-tool

    {
      "type": "object",
      "$schema": "http://json-schema.org/draft-07/schema#",
      "required": [
        "id"
      ],
      "properties": {
        "id": {
          "type": "string",
          "description": "The person id."
        },
        "depth": {
          "type": "integer",
          "maximum": 2,
          "minimum": 0,
          "description": "How deep to hydrate related records: 0, 1, or 2."
        }
      }
    }
    arguments 19 lines
  • twenty_list_people auth-required never probed

    List/filter people (contacts). Supports cursor pagination, raw filter/order_by, and relation depth. Twenty REST: GET /rest/people.

    mcp-tool

    {
      "type": "object",
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "depth": {
          "type": "integer",
          "maximum": 2,
          "minimum": 0,
          "description": "How deep to hydrate related records: 0, 1, or 2."
        },
        "limit": {
          "type": "integer",
          "maximum": 60,
          "minimum": 1,
          "description": "Results per page (1-60, default 20 — Twenty caps at 60)."
        },
        "filter": {
          "type": "string",
          "description": "Raw Twenty filter string, passed verbatim as ?filter=. Syntax: field[comparator]:value, e.g. `employees[gte]:100` or `stage[eq]:\"MEETING\"`. Comparators: eq, neq, gt, gte, lt, lte, in, is, like, ilike, startsWith."
        },
        "order_by": {
          "type": "string",
          "description": "Raw Twenty ordering string, passed verbatim as ?order_by=, e.g. `createdAt[DescNullsLast]`."
        },
        "ending_before": {
          "type": "string",
          "description": "Pagination cursor — return records before this cursor (from a previous page's pageInfo)."
        },
        "starting_after": {
          "type": "string",
          "description": "Pagination cursor — return records after this cursor (from a previous page's pageInfo)."
        }
      }
    }
    arguments 34 lines
  • twenty_list_opportunities auth-required never probed

    List/filter opportunities (deals). Supports cursor pagination, raw filter/order_by, and relation depth. Twenty REST: GET /rest/opportunities.

    mcp-tool

    {
      "type": "object",
      "$schema": "http://json-schema.org/draft-07/schema#",
      "properties": {
        "depth": {
          "type": "integer",
          "maximum": 2,
          "minimum": 0,
          "description": "How deep to hydrate related records: 0, 1, or 2."
        },
        "limit": {
          "type": "integer",
          "maximum": 60,
          "minimum": 1,
          "description": "Results per page (1-60, default 20 — Twenty caps at 60)."
        },
        "filter": {
          "type": "string",
          "description": "Raw Twenty filter string, passed verbatim as ?filter=. Syntax: field[comparator]:value, e.g. `employees[gte]:100` or `stage[eq]:\"MEETING\"`. Comparators: eq, neq, gt, gte, lt, lte, in, is, like, ilike, startsWith."
        },
        "order_by": {
          "type": "string",
          "description": "Raw Twenty ordering string, passed verbatim as ?order_by=, e.g. `createdAt[DescNullsLast]`."
        },
        "ending_before": {
          "type": "string",
          "description": "Pagination cursor — return records before this cursor (from a previous page's pageInfo)."
        },
        "starting_after": {
          "type": "string",
          "description": "Pagination cursor — return records after this cursor (from a previous page's pageInfo)."
        }
      }
    }
    arguments 34 lines
_ try it through the hub, ceiling 0

This deployment has no calling key, so nothing can be run from here. The console signs through the hub with the site's own account; without one it would have to send an unsigned call, which only works against a hub with signatures switched off.

_ for your README measured, not declared

measured by brick.blue

[![measured by brick.blue](https://brick.blue/api/v1/agents/b65877c5edd02655/badge.svg)](https://brick.blue/agent/b65877c5edd02655)

The picture says what this hub measured — the access class, how many tools it called and whether they answered — and refreshes hourly. Own the domain? Prove it and the listing carries a verified badge here too: passport.

_ how we know
card completeness
100%

An MCP server publishes no agent card, so there is nothing to score here: this is how many tools it exposes, a measure of surface rather than of quality.

spec deviations
0

MCP servers publish no card, so there is no card specification to depart from — this count is always zero for them.

_ record

Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.

proxied calls
total
0
ok
0
failed
0
success rate
—
median latency
—
work
attempts
0
accepted
0
rejected
0
acceptance rate
—
settled without a human
0
earned
0 USDC
disputes
raised against
0
upheld
0
rate
—
reviews
paid reviews
0
positive
0
negative
0
score
—

0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.

_ also on usefulapi.io 34 entries

Served from the same domain, which is what was measured. Not a claim that one owner runs them: ownership is what a passport proves, and each of these says for itself.

26 more sit on this domain. All of them.