Copper MCP by usefulapi is an MCP server published by io.usefulapi, hosted at copper.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 27 tools, including copper_search_projects, copper_get_project, copper_list_custom_field_definitions, copper_list_files, copper_get_file_metadata.
Read and write Copper CRM people, companies, opportunities and activities.
4,091 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
List/search Copper Projects. name uses the vendor's name filter. contains_name scans a bounded number of pages locally; inspect complete and continue with next_page before claiming exhaustive results. POST /projects/search.
| Parameter | Type | Description |
|---|---|---|
| name | string | |
| sort_by | string | one of ["name","assigned_to","related_to","status","date_modified","date_created"] |
| max_pages | integer | |
| page_size | integer | |
| page_number | integer | |
| assignee_ids | array | |
| contains_name | string | |
| sort_direction | string | one of ["asc","desc"] |
{
"name": "copper_search_projects",
"title": "Search projects",
"description": "List/search Copper Projects. name uses the vendor's name filter. contains_name scans a bounded number of pages locally; inspect complete and continue with next_page before claiming exhaustive results. POST /projects/search.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"name": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"sort_by": {
"enum": [
"name",
"assigned_to",
"related_to",
"status",
"date_modified",
"date_created"
],
"type": "string"
},
"max_pages": {
"type": "integer",
"maximum": 10,
"exclusiveMinimum": 0
},
"page_size": {
"type": "integer",
"maximum": 200,
"exclusiveMinimum": 0
},
"page_number": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"assignee_ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"maxItems": 100
},
"contains_name": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"sort_direction": {
"enum": [
"asc",
"desc"
],
"type": "string"
}
}
},
"annotations": {
"title": "Read feature data",
"readOnlyHint": true
}
}Read one Copper project, including details and raw custom-field values. GET /projects/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | integer |
{
"name": "copper_get_project",
"title": "Get project",
"description": "Read one Copper project, including details and raw custom-field values. GET /projects/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Read feature data",
"readOnlyHint": true
}
}Map custom_field_definition_id to its label, data type (including URL), options and applicable entities. Existing opportunity/project reads return raw values. A returned private document URL still needs access through its own provider. GET /custom_field_definitions.
| Parameter | Type | Description |
|---|---|---|
| available_on | string | one of ["lead","person","opportunity","company","project","task"] |
{
"name": "copper_list_custom_field_definitions",
"title": "List custom field definitions",
"description": "Map custom_field_definition_id to its label, data type (including URL), options and applicable entities. Existing opportunity/project reads return raw values. A returned private document URL still needs access through its own provider. GET /custom_field_definitions.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"available_on": {
"enum": [
"lead",
"person",
"opportunity",
"company",
"project",
"task"
],
"type": "string"
}
}
},
"annotations": {
"title": "Read feature data",
"readOnlyHint": true
}
}List attached-file IDs, names, sizes, types and timestamps on an opportunity, project or other supported entity. Returns metadata, not file bytes or Google Drive document access. GET /{entity_type}/{entity_id}/files.
| Parameter | Type | Description |
|---|---|---|
| entity_id * | integer | |
| entity_type * | string | one of ["leads","people","opportunities","companies","projects"] |
{
"name": "copper_list_files",
"title": "List attached file metadata",
"description": "List attached-file IDs, names, sizes, types and timestamps on an opportunity, project or other supported entity. Returns metadata, not file bytes or Google Drive document access. GET /{entity_type}/{entity_id}/files.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"entity_type",
"entity_id"
],
"properties": {
"entity_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"entity_type": {
"enum": [
"leads",
"people",
"opportunities",
"companies",
"projects"
],
"type": "string"
}
}
},
"annotations": {
"title": "Read feature data",
"readOnlyHint": true
}
}Read metadata for a file attached to a specific Copper record. The public contract provides no download or Drive-link resolver; this tool does not claim to read the file's contents. GET /{entity_type}/{entity_id}/files/{file_id}.
| Parameter | Type | Description |
|---|---|---|
| file_id * | integer | |
| entity_id * | integer | |
| entity_type * | string | one of ["leads","people","opportunities","companies","projects"] |
{
"name": "copper_get_file_metadata",
"title": "Get attached file metadata",
"description": "Read metadata for a file attached to a specific Copper record. The public contract provides no download or Drive-link resolver; this tool does not claim to read the file's contents. GET /{entity_type}/{entity_id}/files/{file_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"entity_type",
"entity_id",
"file_id"
],
"properties": {
"file_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"entity_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"entity_type": {
"enum": [
"leads",
"people",
"opportunities",
"companies",
"projects"
],
"type": "string"
}
}
},
"annotations": {
"title": "Read feature data",
"readOnlyHint": true
}
}Get details of the authenticated Copper account. Copper REST: GET /account.
No parameters.
{
"name": "copper_get_account",
"title": "Get account",
"description": "Get details of the authenticated Copper account. Copper REST: GET /account.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get account",
"readOnlyHint": true
}
}List users in the Copper account (id, name, email) — useful for resolving assignee ids. Copper REST: POST /users/search.
| Parameter | Type | Description |
|---|---|---|
| page_size | integer | Results per page (default 20, max 200). |
| page_number | integer | 1-based page number to fetch (default 1). |
{
"name": "copper_list_users",
"title": "List users",
"description": "List users in the Copper account (id, name, email) — useful for resolving assignee ids. Copper REST: POST /users/search.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page_size": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Results per page (default 20, max 200)."
},
"page_number": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "1-based page number to fetch (default 1)."
}
}
},
"annotations": {
"title": "List users",
"readOnlyHint": true
}
}Search/list people (contacts). All filters optional; returns a page of people. Copper REST: POST /people/search.
| Parameter | Type | Description |
|---|---|---|
| city | string | City filter. |
| name | string | Full-name filter (substring match). |
| tags | array | Filter to people carrying any of these tags. |
| state | string | State/region filter. |
| emails | array | Filter to people with any of these email addresses. |
| country | string | Country filter. |
| sort_by | string | Field to sort by, e.g. 'name', 'date_created', 'date_modified' (default 'first_name'). |
| page_size | integer | Results per page (default 20, max 200). |
| company_ids | array | Filter to people at these company ids. |
| page_number | integer | 1-based page number to fetch (default 1). |
| assignee_ids | array | Filter to people owned by these user ids. |
Get a single person (contact) by id. Copper REST: GET /people/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | integer | The person id. |
{
"name": "copper_get_person",
"title": "Get person",
"description": "Get a single person (contact) by id. Copper REST: GET /people/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The person id."
}
}
},
"annotations": {
"title": "Get person",
"readOnlyHint": true
}
}Search/list companies. All filters optional; returns a page of companies. Copper REST: POST /companies/search.
| Parameter | Type | Description |
|---|---|---|
| city | string | City filter. |
| name | string | Company-name filter (substring match). |
| tags | array | Filter to companies carrying any of these tags. |
| state | string | State/region filter. |
| country | string | Country filter. |
| sort_by | string | Field to sort by, e.g. 'name', 'date_created' (default 'name'). |
| page_size | integer | Results per page (default 20, max 200). |
| page_number | integer | 1-based page number to fetch (default 1). |
| assignee_ids | array | Filter to companies owned by these user ids. |
| sort_direction | string | Sort direction — 'asc' or 'desc' (default asc). |
Get a single company by id. Copper REST: GET /companies/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | integer | The company id. |
{
"name": "copper_get_company",
"title": "Get company",
"description": "Get a single company by id. Copper REST: GET /companies/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The company id."
}
}
},
"annotations": {
"title": "Get company",
"readOnlyHint": true
}
}Search/list opportunities (deals). All filters optional; returns a page of opportunities. Copper REST: POST /opportunities/search.
| Parameter | Type | Description |
|---|---|---|
| name | string | Opportunity-name filter (substring match). |
| tags | array | Filter to opportunities carrying any of these tags. |
| sort_by | string | Field to sort by, e.g. 'name', 'date_created', 'monetary_value' (default 'name'). |
| page_size | integer | Results per page (default 20, max 200). |
| status_ids | array | Filter by status id: 0=Open, 1=Won, 2=Lost, 3=Abandoned. |
| company_ids | array | Filter to opportunities at these company ids. |
| page_number | integer | 1-based page number to fetch (default 1). |
| assignee_ids | array | Filter to opportunities owned by these user ids. |
| pipeline_ids | array | Filter to opportunities in these pipelines. |
| sort_direction | string | Sort direction — 'asc' or 'desc' (default asc). |
Get a single opportunity (deal) by id. Copper REST: GET /opportunities/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | integer | The opportunity id. |
{
"name": "copper_get_opportunity",
"title": "Get opportunity",
"description": "Get a single opportunity (deal) by id. Copper REST: GET /opportunities/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The opportunity id."
}
}
},
"annotations": {
"title": "Get opportunity",
"readOnlyHint": true
}
}Search/list leads. All filters optional; returns a page of leads. Copper REST: POST /leads/search.
| Parameter | Type | Description |
|---|---|---|
| city | string | City filter. |
| name | string | Lead-name filter (substring match). |
| tags | array | Filter to leads carrying any of these tags. |
| state | string | State/region filter. |
| emails | array | Filter to leads with any of these email addresses. |
| country | string | Country filter. |
| sort_by | string | Field to sort by, e.g. 'name', 'date_created' (default 'name'). |
| page_size | integer | Results per page (default 20, max 200). |
| page_number | integer | 1-based page number to fetch (default 1). |
| assignee_ids | array | Filter to leads owned by these user ids. |
| sort_direction | string | Sort direction — 'asc' or 'desc' (default asc). |
Get a single lead by id. Copper REST: GET /leads/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | integer | The lead id. |
{
"name": "copper_get_lead",
"title": "Get lead",
"description": "Get a single lead by id. Copper REST: GET /leads/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The lead id."
}
}
},
"annotations": {
"title": "Get lead",
"readOnlyHint": true
}
}Search/list tasks. All filters optional; returns a page of tasks. Copper REST: POST /tasks/search.
| Parameter | Type | Description |
|---|---|---|
| name | string | Task-name filter (substring match). |
| status | string | Filter by task status. |
| sort_by | string | Field to sort by, e.g. 'name', 'due_date', 'date_created' (default 'name'). |
| page_size | integer | Results per page (default 20, max 200). |
| page_number | integer | 1-based page number to fetch (default 1). |
| assignee_ids | array | Filter to tasks owned by these user ids. |
| sort_direction | string | Sort direction — 'asc' or 'desc' (default asc). |
{
"name": "copper_search_tasks",
"title": "Search tasks",
"description": "Search/list tasks. All filters optional; returns a page of tasks. Copper REST: POST /tasks/search.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"name": {
"type": "string",
"description": "Task-name filter (substring match)."
},
"status": {
"enum": [
"Open",
"Completed"
],
"type": "string",
"description": "Filter by task status."
},
"sort_by": {
"type": "string",
"description": "Field to sort by, e.g. 'name', 'due_date', 'date_created' (default 'name')."
},
"page_size": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Results per page (default 20, max 200)."
},
"page_number": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "1-based page number to fetch (default 1)."
},
"assignee_ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"description": "Filter to tasks owned by these user ids."
},
"sort_direction": {
"enum": [
"asc",
"desc"
],
"type": "string",
"description": "Sort direction — 'asc' or 'desc' (default asc)."
}
}
},
"annotations": {
"title": "Search tasks",
"readOnlyHint": true
}
}Get a single task by id. Copper REST: GET /tasks/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | integer | The task id. |
{
"name": "copper_get_task",
"title": "Get task",
"description": "Get a single task by id. Copper REST: GET /tasks/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The task id."
}
}
},
"annotations": {
"title": "Get task",
"readOnlyHint": true
}
}List activities (notes, calls, meetings, system events) attached to a record. Copper REST: POST /activities/search.
| Parameter | Type | Description |
|---|---|---|
| page_size | integer | Results per page (default 20, max 200). |
| parent_id | integer | The id of the parent record to list activities for (requires parent_type). |
| page_number | integer | 1-based page number to fetch (default 1). |
| parent_type | string | Restrict to activities on a single record of this type (requires parent_id). |
| maximum_activity_date | integer | Latest activity date, as a Unix timestamp (seconds). |
| minimum_activity_date | integer | Earliest activity date, as a Unix timestamp (seconds). |
{
"name": "copper_list_activities",
"title": "List activities",
"description": "List activities (notes, calls, meetings, system events) attached to a record. Copper REST: POST /activities/search.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page_size": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Results per page (default 20, max 200)."
},
"parent_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The id of the parent record to list activities for (requires parent_type)."
},
"page_number": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "1-based page number to fetch (default 1)."
},
"parent_type": {
"enum": [
"lead",
"person",
"company",
"opportunity",
"project",
"task"
],
"type": "string",
"description": "Restrict to activities on a single record of this type (requires parent_id)."
},
"maximum_activity_date": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Latest activity date, as a Unix timestamp (seconds)."
},
"minimum_activity_date": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Earliest activity date, as a Unix timestamp (seconds)."
}
}
},
"annotations": {
"title": "List activities",
"readOnlyHint": true
}
}List the account's activity types (user + system), needed to log an activity. Copper REST: GET /activity_types.
No parameters.
{
"name": "copper_list_activity_types",
"title": "List activity types",
"description": "List the account's activity types (user + system), needed to log an activity. Copper REST: GET /activity_types.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List activity types",
"readOnlyHint": true
}
}List sales pipelines and their stages (ids needed to place opportunities). Copper REST: GET /pipelines.
No parameters.
{
"name": "copper_list_pipelines",
"title": "List pipelines",
"description": "List sales pipelines and their stages (ids needed to place opportunities). Copper REST: GET /pipelines.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List pipelines",
"readOnlyHint": true
}
}Create a new person (contact). Copper REST: POST /people.
| Parameter | Type | Description |
|---|---|---|
| name * | string | The person's full name (required). |
| tags | array | Tags to apply. |
| title | string | Job title. |
| emails | array | Email addresses for the person. |
| details | string | Freeform description / notes. |
| company_id | integer | Id of the company this person works at. |
| assignee_id | integer | User id to own this person. |
| company_name | string | Company name (if not linking by company_id). |
| phone_numbers | array | Phone numbers for the person. |
{
"name": "copper_create_person",
"title": "Create person",
"description": "Create a new person (contact). Copper REST: POST /people.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "The person's full name (required)."
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Tags to apply."
},
"title": {
"type": "string",
"description": "Job title."
},
"emails": {
"type": "array",
"items": {
"type": "object",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"description": "Email address."
},
"category": {
"type": "string",
"description": "Category label, e.g. 'work' or 'home' (default 'work')."
}
},
"description": "An email entry."
},
"description": "Email addresses for the person."
},
"details": {
"type": "string",
"description": "Freeform description / notes."
},
"company_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Id of the company this person works at."
},
"assignee_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "User id to own this person."
},
"company_name": {
"type": "string",
"description": "Company name (if not linking by company_id)."
},
"phone_numbers": {
"type": "array",
"items": {
"type": "object",
"required": [
"number"
],
"properties": {
"number": {
"type": "string",
"description": "Phone number."
},
"category": {
"type": "string",
"description": "Category label, e.g. 'work', 'mobile', 'home'."
}
},
"description": "A phone-number entry."
},
"description": "Phone numbers for the person."
}
}
},
"annotations": {
"title": "Create person",
"destructiveHint": true
}
}Update fields on an existing person. Only provided fields are changed. Copper REST: PUT /people/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | integer | The person id to update. |
| name | string | The person's full name. |
| tags | array | Replace the person's tags. |
| title | string | Job title. |
| emails | array | Replace the person's email addresses. |
| details | string | Freeform description / notes. |
| company_id | integer | Id of the company this person works at. |
| assignee_id | integer | User id to own this person. |
| phone_numbers | array | Replace the person's phone numbers. |
{
"name": "copper_update_person",
"title": "Update person",
"description": "Update fields on an existing person. Only provided fields are changed. Copper REST: PUT /people/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The person id to update."
},
"name": {
"type": "string",
"description": "The person's full name."
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Replace the person's tags."
},
"title": {
"type": "string",
"description": "Job title."
},
"emails": {
"type": "array",
"items": {
"type": "object",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"description": "Email address."
},
"category": {
"type": "string",
"description": "Category label, e.g. 'work' or 'home' (default 'work')."
}
},
"description": "An email entry."
},
"description": "Replace the person's email addresses."
},
"details": {
"type": "string",
"description": "Freeform description / notes."
},
"company_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Id of the company this person works at."
},
"assignee_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "User id to own this person."
},
"phone_numbers": {
"type": "array",
"items": {
"type": "object",
"required": [
"number"
],
"properties": {
"number": {
"type": "string",
"description": "Phone number."
},
"category": {
"type": "string",
"description": "Category label, e.g. 'work', 'mobile', 'home'."
}
},
"description": "A phone-number entry."
},
"description": "Replace the person's phone numbers."
}
}
},
"annotations": {
"title": "Update person",
"destructiveHint": true
}
}Create a new company. Copper REST: POST /companies.
| Parameter | Type | Description |
|---|---|---|
| name * | string | The company name (required). |
| tags | array | Tags to apply. |
| details | string | Freeform description / notes. |
| assignee_id | integer | User id to own this company. |
| email_domain | string | The company's email domain, e.g. example.com. |
| phone_numbers | array | Phone numbers for the company. |
{
"name": "copper_create_company",
"title": "Create company",
"description": "Create a new company. Copper REST: POST /companies.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "The company name (required)."
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Tags to apply."
},
"details": {
"type": "string",
"description": "Freeform description / notes."
},
"assignee_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "User id to own this company."
},
"email_domain": {
"type": "string",
"description": "The company's email domain, e.g. example.com."
},
"phone_numbers": {
"type": "array",
"items": {
"type": "object",
"required": [
"number"
],
"properties": {
"number": {
"type": "string",
"description": "Phone number."
},
"category": {
"type": "string",
"description": "Category label, e.g. 'work', 'mobile', 'home'."
}
},
"description": "A phone-number entry."
},
"description": "Phone numbers for the company."
}
}
},
"annotations": {
"title": "Create company",
"destructiveHint": true
}
}Create a new opportunity (deal). `name` and `primary_contact_id` are required by Copper. Copper REST: POST /opportunities.
| Parameter | Type | Description |
|---|---|---|
| name * | string | The opportunity name (required). |
| tags | array | Tags to apply. |
| details | string | Freeform description / notes. |
| close_date | string | Expected close date, formatted MM/DD/YYYY. |
| company_id | integer | Id of the associated company. |
| assignee_id | integer | User id to own this opportunity. |
| pipeline_id | integer | Id of the pipeline to place the opportunity in. |
| monetary_value | number | Deal value (in the account's currency). |
| pipeline_stage_id | integer | Id of the pipeline stage. |
| primary_contact_id * | integer | Id of the primary contact (person) for this opportunity (required by Copper). |
Create a new lead. Copper REST: POST /leads.
| Parameter | Type | Description |
|---|---|---|
| name * | string | The lead's name (required). |
| tags | array | Tags to apply. |
| object | The lead's email. | |
| title | string | Job title. |
| details | string | Freeform description / notes. |
| assignee_id | integer | User id to own this lead. |
| company_name | string | Company name the lead is associated with. |
| phone_numbers | array | Phone numbers for the lead. |
| monetary_value | number | Estimated value of the lead. |
| customer_source_id | integer | Id of the customer source. |
Create a new task. Copper REST: POST /tasks.
| Parameter | Type | Description |
|---|---|---|
| name * | string | The task name (required). |
| tags | array | Tags to apply. |
| details | string | Freeform description / notes. |
| due_date | integer | Due date as a Unix timestamp (seconds). |
| priority | string | Task priority. |
| assignee_id | integer | User id to own this task. |
| reminder_date | integer | Reminder date as a Unix timestamp (seconds). |
| related_resource_id | integer | Id of the record to attach the task to (requires related_resource_type). |
| related_resource_type | string | Type of record to attach the task to (requires related_resource_id). |
{
"name": "copper_create_task",
"title": "Create task",
"description": "Create a new task. Copper REST: POST /tasks.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "The task name (required)."
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Tags to apply."
},
"details": {
"type": "string",
"description": "Freeform description / notes."
},
"due_date": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Due date as a Unix timestamp (seconds)."
},
"priority": {
"enum": [
"None",
"High"
],
"type": "string",
"description": "Task priority."
},
"assignee_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "User id to own this task."
},
"reminder_date": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Reminder date as a Unix timestamp (seconds)."
},
"related_resource_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Id of the record to attach the task to (requires related_resource_type)."
},
"related_resource_type": {
"enum": [
"lead",
"person",
"company",
"opportunity",
"project",
"task"
],
"type": "string",
"description": "Type of record to attach the task to (requires related_resource_id)."
}
}
},
"annotations": {
"title": "Create task",
"destructiveHint": true
}
}Log a user activity (e.g. a note or call) on a record. Get the activity_type_id from copper_list_activity_types. Copper REST: POST /activities.
| Parameter | Type | Description |
|---|---|---|
| details * | string | The activity note / description text. |
| parent_id * | integer | The id of the record to attach the activity to. |
| parent_type * | string | The kind of record to attach the activity to. |
| activity_date | integer | When the activity occurred, as a Unix timestamp (seconds). Defaults to now. |
| activity_type_id * | integer | Id of a 'user' activity type (from copper_list_activity_types). |
{
"name": "copper_log_activity",
"title": "Log activity",
"description": "Log a user activity (e.g. a note or call) on a record. Get the activity_type_id from copper_list_activity_types. Copper REST: POST /activities.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"parent_type",
"parent_id",
"activity_type_id",
"details"
],
"properties": {
"details": {
"type": "string",
"description": "The activity note / description text."
},
"parent_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The id of the record to attach the activity to."
},
"parent_type": {
"enum": [
"lead",
"person",
"company",
"opportunity",
"project",
"task"
],
"type": "string",
"description": "The kind of record to attach the activity to."
},
"activity_date": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "When the activity occurred, as a Unix timestamp (seconds). Defaults to now."
},
"activity_type_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Id of a 'user' activity type (from copper_list_activity_types)."
}
}
},
"annotations": {
"title": "Log activity",
"destructiveHint": true
}
}Tools for Copper, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which open deals in my pipeline are worth the most?"; "Show the 20 most recently created leads in our customer records."; "List open follow-up tasks in order of due date.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Copper data. Free plan: 50 tool calls per month. Run copper_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run copper_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run copper_upgrade without a plan: it returns both plans, each with a payment link for the user to open. copper_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| phone_number | string | Phone-number filter. |
| sort_direction | string | Sort direction — 'asc' or 'desc' (default asc). |
{
"name": "copper_search_people",
"title": "Search people",
"description": "Search/list people (contacts). All filters optional; returns a page of people. Copper REST: POST /people/search.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"city": {
"type": "string",
"description": "City filter."
},
"name": {
"type": "string",
"description": "Full-name filter (substring match)."
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Filter to people carrying any of these tags."
},
"state": {
"type": "string",
"description": "State/region filter."
},
"emails": {
"type": "array",
"items": {
"type": "string"
},
"description": "Filter to people with any of these email addresses."
},
"country": {
"type": "string",
"description": "Country filter."
},
"sort_by": {
"type": "string",
"description": "Field to sort by, e.g. 'name', 'date_created', 'date_modified' (default 'first_name')."
},
"page_size": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Results per page (default 20, max 200)."
},
"company_ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"description": "Filter to people at these company ids."
},
"page_number": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "1-based page number to fetch (default 1)."
},
"assignee_ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"description": "Filter to people owned by these user ids."
},
"phone_number": {
"type": "string",
"description": "Phone-number filter."
},
"sort_direction": {
"enum": [
"asc",
"desc"
],
"type": "string",
"description": "Sort direction — 'asc' or 'desc' (default asc)."
}
}
},
"annotations": {
"title": "Search people",
"readOnlyHint": true
}
}{
"name": "copper_search_companies",
"title": "Search companies",
"description": "Search/list companies. All filters optional; returns a page of companies. Copper REST: POST /companies/search.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"city": {
"type": "string",
"description": "City filter."
},
"name": {
"type": "string",
"description": "Company-name filter (substring match)."
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Filter to companies carrying any of these tags."
},
"state": {
"type": "string",
"description": "State/region filter."
},
"country": {
"type": "string",
"description": "Country filter."
},
"sort_by": {
"type": "string",
"description": "Field to sort by, e.g. 'name', 'date_created' (default 'name')."
},
"page_size": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Results per page (default 20, max 200)."
},
"page_number": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "1-based page number to fetch (default 1)."
},
"assignee_ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"description": "Filter to companies owned by these user ids."
},
"sort_direction": {
"enum": [
"asc",
"desc"
],
"type": "string",
"description": "Sort direction — 'asc' or 'desc' (default asc)."
}
}
},
"annotations": {
"title": "Search companies",
"readOnlyHint": true
}
}| pipeline_stage_ids |
| array |
| Filter to opportunities at these pipeline stages. |
{
"name": "copper_search_opportunities",
"title": "Search opportunities",
"description": "Search/list opportunities (deals). All filters optional; returns a page of opportunities. Copper REST: POST /opportunities/search.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"name": {
"type": "string",
"description": "Opportunity-name filter (substring match)."
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Filter to opportunities carrying any of these tags."
},
"sort_by": {
"type": "string",
"description": "Field to sort by, e.g. 'name', 'date_created', 'monetary_value' (default 'name')."
},
"page_size": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Results per page (default 20, max 200)."
},
"status_ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"description": "Filter by status id: 0=Open, 1=Won, 2=Lost, 3=Abandoned."
},
"company_ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"description": "Filter to opportunities at these company ids."
},
"page_number": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "1-based page number to fetch (default 1)."
},
"assignee_ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"description": "Filter to opportunities owned by these user ids."
},
"pipeline_ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"description": "Filter to opportunities in these pipelines."
},
"sort_direction": {
"enum": [
"asc",
"desc"
],
"type": "string",
"description": "Sort direction — 'asc' or 'desc' (default asc)."
},
"pipeline_stage_ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"description": "Filter to opportunities at these pipeline stages."
}
}
},
"annotations": {
"title": "Search opportunities",
"readOnlyHint": true
}
}| customer_source_ids | array | Filter by customer-source ids. |
{
"name": "copper_search_leads",
"title": "Search leads",
"description": "Search/list leads. All filters optional; returns a page of leads. Copper REST: POST /leads/search.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"city": {
"type": "string",
"description": "City filter."
},
"name": {
"type": "string",
"description": "Lead-name filter (substring match)."
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Filter to leads carrying any of these tags."
},
"state": {
"type": "string",
"description": "State/region filter."
},
"emails": {
"type": "array",
"items": {
"type": "string"
},
"description": "Filter to leads with any of these email addresses."
},
"country": {
"type": "string",
"description": "Country filter."
},
"sort_by": {
"type": "string",
"description": "Field to sort by, e.g. 'name', 'date_created' (default 'name')."
},
"page_size": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Results per page (default 20, max 200)."
},
"page_number": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "1-based page number to fetch (default 1)."
},
"assignee_ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"description": "Filter to leads owned by these user ids."
},
"sort_direction": {
"enum": [
"asc",
"desc"
],
"type": "string",
"description": "Sort direction — 'asc' or 'desc' (default asc)."
},
"customer_source_ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"description": "Filter by customer-source ids."
}
}
},
"annotations": {
"title": "Search leads",
"readOnlyHint": true
}
}{
"name": "copper_create_opportunity",
"title": "Create opportunity",
"description": "Create a new opportunity (deal). `name` and `primary_contact_id` are required by Copper. Copper REST: POST /opportunities.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"primary_contact_id"
],
"properties": {
"name": {
"type": "string",
"description": "The opportunity name (required)."
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Tags to apply."
},
"details": {
"type": "string",
"description": "Freeform description / notes."
},
"close_date": {
"type": "string",
"description": "Expected close date, formatted MM/DD/YYYY."
},
"company_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Id of the associated company."
},
"assignee_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "User id to own this opportunity."
},
"pipeline_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Id of the pipeline to place the opportunity in."
},
"monetary_value": {
"type": "number",
"description": "Deal value (in the account's currency)."
},
"pipeline_stage_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Id of the pipeline stage."
},
"primary_contact_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Id of the primary contact (person) for this opportunity (required by Copper)."
}
}
},
"annotations": {
"title": "Create opportunity",
"destructiveHint": true
}
}{
"name": "copper_create_lead",
"title": "Create lead",
"description": "Create a new lead. Copper REST: POST /leads.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "The lead's name (required)."
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Tags to apply."
},
"email": {
"type": "object",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"description": "Email address."
},
"category": {
"type": "string",
"description": "Category label, e.g. 'work' or 'home' (default 'work')."
}
},
"description": "The lead's email."
},
"title": {
"type": "string",
"description": "Job title."
},
"details": {
"type": "string",
"description": "Freeform description / notes."
},
"assignee_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "User id to own this lead."
},
"company_name": {
"type": "string",
"description": "Company name the lead is associated with."
},
"phone_numbers": {
"type": "array",
"items": {
"type": "object",
"required": [
"number"
],
"properties": {
"number": {
"type": "string",
"description": "Phone number."
},
"category": {
"type": "string",
"description": "Category label, e.g. 'work', 'mobile', 'home'."
}
},
"description": "A phone-number entry."
},
"description": "Phone numbers for the lead."
},
"monetary_value": {
"type": "number",
"description": "Estimated value of the lead."
},
"customer_source_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Id of the customer source."
}
}
},
"annotations": {
"title": "Create lead",
"destructiveHint": true
}
}