Koban MCP by usefulapi

Read accounts, leads and deals; save accounts and contacts, add actions in Koban.

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
96%
Naming quality
79%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Findings (1)

  • LOWTool 'koban_get_account_by_external_code' name length outside 3-30 rangein koban_get_account_by_external_code

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~3,668Tokens (tool definitions)
~1.2 KBTypical response size
Significant attention impact (2.87% 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": {
    "koban": {
      "url": "https://koban.usefulapi.io/mcp"
    }
  }
}

Remote endpoints

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

What it can do

Tool inventory

Tools (21)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢koban_list_users

List the users of the Koban account (login, name, active state). Use it to find the user id for assignments. Koban API: GET /ncAuthenticate/GetUsers.

Input Schema

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

Search Koban accounts (companies and persons) by label. Returns matching accounts with status, type and assignment. Koban API: GET /ncThird/GetByLabel.

Input Schema

{
  "type": "object",
  "properties": {
    "search": {
      "type": "string",
      "minLength": 1,
      "description": "Text to find in the account label."
    }
  },
  "required": [
    "search"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢koban_get_account(id)

Get one Koban account by its id, including address, status, type, tags and custom fields. Koban API: GET /ncThird/GetOne.

Input Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "The Koban object id (GUID, from a list or get tool)."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢koban_get_account_by_external_code(extcode)

Get one Koban account by your own external code (Extcode). Use it when your system stores the Koban link by external code. Koban API: GET /ncThird/GetOneByExtcode.

Input Schema

{
  "type": "object",
  "properties": {
    "extcode": {
      "type": "string",
      "minLength": 1,
      "description": "Your own external code for the record (Koban Extcode)."
    }
  },
  "required": [
    "extcode"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢koban_list_updated_accounts(updated, structcode, offset, limit)

List accounts changed after a Unix time, one page at a time. Use it for incremental sync. Koban API: GET /ncThird/GetUpdated.

Input Schema

{
  "type": "object",
  "properties": {
    "updated": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "Unix time in seconds. Only records changed after this time are returned (example: 1555008374)."
    },
    "structcode": {
      "description": "Only accounts of this structure code (optional).",
      "type": "string"
    },
    "offset": {
      "description": "Start offset of the page (default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "limit": {
      "description": "Records per page (the vendor examples use 20).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "updated"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢koban_find_contact_by_email(email)

Find Koban contacts by their e-mail address. Returns the matching contacts and their accounts. Koban API: GET /ncContact/GetByEMail.

Input Schema

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "format": "email",
      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "description": "The e-mail address to find."
    }
  },
  "required": [
    "email"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢koban_get_contact(id)

Get one Koban contact by its id, including name, e-mail, phone, function and tags. Koban API: GET /ncContact/GetOne.

Input Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "The Koban object id (GUID, from a list or get tool)."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢koban_list_updated_contacts(updated, offset, limit)

List contacts changed after a Unix time, one page at a time. Use it for incremental sync. Koban API: GET /ncContact/GetUpdated.

Input Schema

{
  "type": "object",
  "properties": {
    "updated": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "Unix time in seconds. Only records changed after this time are returned (example: 1555008374)."
    },
    "offset": {
      "description": "Start offset of the page (default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "limit": {
      "description": "Records per page (the vendor examples use 20).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "updated"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢koban_get_lead(id)

Get one Koban lead by its id, including the person, company, status and tags. Koban API: GET /ncLead/GetOne.

Input Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "The Koban object id (GUID, from a list or get tool)."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢koban_list_leads_by_status(status, offset, sort)

List Koban leads that have one status code (for example MQL), one page at a time. Koban API: GET /ncLead/GetByStatus.

Input Schema

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "minLength": 1,
      "description": "The lead status code from your Koban lists (for example MQL)."
    },
    "offset": {
      "description": "Start offset of the page (default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "sort": {
      "description": "Sort field for the list, for example CreationDate.",
      "type": "string"
    }
  },
  "required": [
    "status"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢koban_get_deal(id)

Get one Koban deal by its id, including its process, amount, owner and status. Koban API: GET /ncDeal/GetOne.

Input Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "The Koban object id (GUID, from a list or get tool)."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢koban_list_deals_for_account(account_id)

List all Koban deals linked to one account id. Koban API: GET /ncDeal/GetForThird.

Input Schema

{
  "type": "object",
  "properties": {
    "account_id": {
      "type": "string",
      "minLength": 1,
      "description": "The account id (GUID) from koban_search_accounts."
    }
  },
  "required": [
    "account_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢koban_list_updated_deals(updated, offset, limit)

List deals changed after a Unix time, one page at a time. Use it for incremental sync. Koban API: GET /ncDeal/GetUpdated.

Input Schema

{
  "type": "object",
  "properties": {
    "updated": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "Unix time in seconds. Only records changed after this time are returned (example: 1555008374)."
    },
    "offset": {
      "description": "Start offset of the page (default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "limit": {
      "description": "Records per page (the vendor examples use 20).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "updated"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢koban_get_invoice(id)

Get one Koban invoice by its id, including number, amounts, status and lines. Koban API: GET /ncInvoice/GetOne.

Input Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "The Koban object id (GUID, from a list or get tool)."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢koban_list_updated_invoices(updated, offset, limit)

List invoices changed after a Unix time, one page at a time. Use it for incremental sync. Koban API: GET /ncInvoice/GetUpdated.

Input Schema

{
  "type": "object",
  "properties": {
    "updated": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "Unix time in seconds. Only records changed after this time are returned (example: 1555008374)."
    },
    "offset": {
      "description": "Start offset of the page (default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "limit": {
      "description": "Records per page (the vendor examples use 20).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "updated"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢koban_list_updated_orders(updated, offset, limit)

List orders changed after a Unix time, one page at a time. Koban API: GET /ncOrder/GetUpdated.

Input Schema

{
  "type": "object",
  "properties": {
    "updated": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "Unix time in seconds. Only records changed after this time are returned (example: 1555008374)."
    },
    "offset": {
      "description": "Start offset of the page (default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "limit": {
      "description": "Records per page (the vendor examples use 20).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "updated"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢koban_get_action(id)

Get one Koban action (task, call or meeting) by its id. Koban API: GET /ncAction/Get.

Input Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "The Koban object id (GUID, from a list or get tool)."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢koban_list_pending_actions(user_id, from, to, updated, offset, ...)

List the open actions of one user, optionally in a date range. Koban API: GET /ncAction/GetPending.

Input Schema

{
  "type": "object",
  "properties": {
    "user_id": {
      "description": "The user id (GUID) from koban_list_users.",
      "type": "string"
    },
    "from": {
      "description": "Start date yyyy-mm-dd.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "to": {
      "description": "End date yyyy-mm-dd.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "updated": {
      "description": "Only actions changed after this date yyyy-mm-dd.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "offset": {
      "description": "Start offset of the page (default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "sort": {
      "description": "Sort field for the list, for example CreationDate.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟡koban_upsert_account(extcode, label, status_code, type_code, comments)

Create an account, or update the account that has this external code. Existing fields not sent are kept. Koban API: POST /ncThird/PostOne with uniqueproperty=Extcode.

Input Schema

{
  "type": "object",
  "properties": {
    "extcode": {
      "type": "string",
      "minLength": 1,
      "description": "Your own external code for the record (Koban Extcode)."
    },
    "label": {
      "type": "string",
      "minLength": 1,
      "description": "The account name (company name or person name)."
    },
    "status_code": {
      "description": "The account status code (for example CLI for a client).",
      "type": "string"
    },
    "type_code": {
      "description": "The account type code (for example PRO or PER).",
      "type": "string"
    },
    "comments": {
      "description": "Free-text comments on the account.",
      "type": "string"
    }
  },
  "required": [
    "extcode",
    "label"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟡koban_upsert_contact(extcode, name, first_name, email, phone, ...)

Create a contact, or update the contact that has this external code. Optionally link it to an account by the account's external code. Koban API: POST /ncContact/PostOne.

Input Schema

{
  "type": "object",
  "properties": {
    "extcode": {
      "type": "string",
      "minLength": 1,
      "description": "Your own external code for the record (Koban Extcode)."
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "The contact's last name."
    },
    "first_name": {
      "description": "The contact's first name.",
      "type": "string"
    },
    "email": {
      "description": "The contact's e-mail address.",
      "type": "string",
      "format": "email",
      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
    },
    "phone": {
      "description": "The contact's phone number.",
      "type": "string"
    },
    "cell": {
      "description": "The contact's mobile number.",
      "type": "string"
    },
    "function": {
      "description": "The contact's job title.",
      "type": "string"
    },
    "account_extcode": {
      "description": "External code of the account to link the contact to.",
      "type": "string"
    }
  },
  "required": [
    "extcode",
    "name"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴koban_create_action(label, status_code, comments, priority_code, assigned_to_guid, ...)

Create a new action (task, call or meeting) for a user, linked to an account or a deal. Each call creates a new action; a retry creates a duplicate. Koban API: POST /ncAction/Post.

Input Schema

{
  "type": "object",
  "properties": {
    "label": {
      "type": "string",
      "minLength": 1,
      "description": "The action title."
    },
    "status_code": {
      "type": "string",
      "minLength": 1,
      "description": "The action status code from your Koban settings (for example NDEM)."
    },
    "comments": {
      "description": "Free-text description of the action.",
      "type": "string"
    },
    "priority_code": {
      "description": "The priority code (for example NOR).",
      "type": "string"
    },
    "assigned_to_guid": {
      "description": "The user id (GUID) the action is assigned to.",
      "type": "string"
    },
    "account_guid": {
      "description": "The account id (GUID) to link the action to.",
      "type": "string"
    },
    "account_extcode": {
      "description": "The account external code, if no account id is given.",
      "type": "string"
    },
    "deal_guid": {
      "description": "The deal id (GUID) to link the action to.",
      "type": "string"
    }
  },
  "required": [
    "label",
    "status_code"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded21 tools