HERO Software MCP by usefulapi is an MCP server published by io.usefulapi, hosted at hero-software.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 5 tools, including hero_list_contacts, hero_list_projects, hero_get_project, hero_list_documents, hero_run_query.
Read contacts, projects, documents and log entries, and run read-only queries in HERO Software.
4,107 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 contacts (customers and others) with number, name, company, email, phone and address. Filter by category (for example 'customer'). Page with offset. HERO GraphQL query: contacts.
| Parameter | Type | Description |
|---|---|---|
| offset | integer | Number of contacts to skip (default 0). |
| category | string | Contact category, for example 'customer'. |
{
"name": "hero_list_contacts",
"title": "List contacts",
"description": "List contacts (customers and others) with number, name, company, email, phone and address. Filter by category (for example 'customer'). Page with offset. HERO GraphQL query: contacts.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Number of contacts to skip (default 0)."
},
"category": {
"type": "string",
"pattern": "^[A-Za-z_]+$",
"description": "Contact category, for example 'customer'."
}
}
},
"annotations": {
"title": "List contacts",
"readOnlyHint": true
}
}List projects with project number, trade (measure), customer, contact person, project address and status. Pass ids to fetch only some projects. HERO GraphQL query: project_matches.
| Parameter | Type | Description |
|---|---|---|
| ids | array | Project ids to fetch. Leave empty for all projects. |
{
"name": "hero_list_projects",
"title": "List projects",
"description": "List projects with project number, trade (measure), customer, contact person, project address and status. Pass ids to fetch only some projects. HERO GraphQL query: project_matches.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"maxItems": 50,
"minItems": 1,
"description": "Project ids to fetch. Leave empty for all projects."
}
}
},
"annotations": {
"title": "List projects",
"readOnlyHint": true
}
}Get one project by id with its customer documents (type, number, value, file link) and its history entries (log book). HERO GraphQL query: project_matches(ids).
| Parameter | Type | Description |
|---|---|---|
| project_id * | integer | The project id (from hero_list_projects). |
{
"name": "hero_get_project",
"title": "Get a project with documents and log",
"description": "Get one project by id with its customer documents (type, number, value, file link) and its history entries (log book). HERO GraphQL query: project_matches(ids).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"project_id"
],
"properties": {
"project_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The project id (from hero_list_projects).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get a project with documents and log",
"readOnlyHint": true
}
}List customer documents (offers, invoices and so on) with number, date, value, VAT, status, document type and file link. HERO GraphQL query: customer_documents.
No parameters.
{
"name": "hero_list_documents",
"title": "List documents",
"description": "List customer documents (offers, invoices and so on) with number, date, value, VAT, status, document type and file link. HERO GraphQL query: customer_documents.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List documents",
"readOnlyHint": true
}
}Run any read-only GraphQL query on the HERO API, for example calendar_events or supply_product_versions, or a schema introspection ({ __schema { queryType { fields { name } } } }). Mutations and subscriptions are refused. The schema is only visible by introspection with your key.
| Parameter | Type | Description |
|---|---|---|
| query * | string | A GraphQL query document. |
| variables | object | GraphQL variables as an object. |
{
"name": "hero_run_query",
"title": "Run a read-only GraphQL query",
"description": "Run any read-only GraphQL query on the HERO API, for example calendar_events or supply_product_versions, or a schema introspection ({ __schema { queryType { fields { name } } } }). Mutations and subscriptions are refused. The schema is only visible by introspection with your key.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"maxLength": 20000,
"minLength": 1,
"description": "A GraphQL query document."
},
"variables": {
"type": "object",
"description": "GraphQL variables as an object.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"annotations": {
"title": "Run a read-only GraphQL query",
"readOnlyHint": true
}
}Tools for HERO Software, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "List my customers in HERO and show their email and address."; "Which projects are open, and who is the customer of each?"; "Show the documents and log entries of project 150798.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes HERO Software data. Free plan: 50 tool calls per month. Run hero_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 hero_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 hero_upgrade without a plan: it returns both plans, each with a payment link for the user to open. hero_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.