MCP tools

This list is generated from the met.cards MCP server itself, so it always matches what your assistant sees. To connect an assistant, see Connect your AI assistant.

A tool marked Needs Read & write works only with a token or app you granted Read & write access. With Read access it answers that the connection is read-only.

add_note

Needs Read & write

Add a note to a connection. Requires write scope.

Argument	Type	Required	Description
connectionId	string (uuid)	Yes	Connection id
text	string	Yes	Note text (1-2000 chars)

Input schema (JSON Schema)

{
  "type": "object",
  "properties": {
    "connectionId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Connection id"
    },
    "text": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000,
      "description": "Note text (1-2000 chars)"
    }
  },
  "required": [
    "connectionId",
    "text"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

complete_promise

Needs Read & write

Mark a promise as complete. Requires write scope.

Argument	Type	Required	Description
promiseId	string (uuid)	Yes	Promise id

Input schema (JSON Schema)

{
  "type": "object",
  "properties": {
    "promiseId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Promise id"
    }
  },
  "required": [
    "promiseId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

draft_followup

Needs Read & write

Draft a follow-up for a connection. Needs a note or voice memo already on the connection. Requires write scope.

Argument	Type	Required	Description
connectionId	string (uuid)	Yes	Connection id

Input schema (JSON Schema)

{
  "type": "object",
  "properties": {
    "connectionId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Connection id"
    }
  },
  "required": [
    "connectionId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_connection

Read

Get details about a specific connection, including its timeline and promises.

Argument	Type	Required	Description
connectionId	string (uuid)	Yes	Connection id

Input schema (JSON Schema)

{
  "type": "object",
  "properties": {
    "connectionId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Connection id"
    }
  },
  "required": [
    "connectionId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_next_moves

Read

List the member's next moves: promises and connections due for follow-up.

Argument	Type	Required	Description
limit	integer	No	Max results (1-20, default 10)

Input schema (JSON Schema)

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Max results (1-20, default 10)",
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_open_promises

Read

List the member's open promises, soonest due first.

Argument	Type	Required	Description
limit	integer	No	Max results (1-50, default 20)

Input schema (JSON Schema)

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Max results (1-50, default 20)",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_reconnect_nudges

Read

List people suggested for reconnection.

No arguments.

Input schema (JSON Schema)

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

search_connections

Read

Search the member's connections by name, company, or other details.

Argument	Type	Required	Description
query	string	No	Search query (<=120 chars)
limit	integer	No	Max results (1-50, default 20)

Input schema (JSON Schema)

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Search query (<=120 chars)",
      "type": "string",
      "maxLength": 120
    },
    "limit": {
      "description": "Max results (1-50, default 20)",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

For the HTTP API, see the REST API reference.