Server definition

Hash: sha256:d603dc4d7664f460943d328b40e98ec5119bd5f420fbeb1d403a8bcfca6cb9b4
What it is: What a remote MCP server returned when asked what it offers: 17 tools

The blob, as servednamed by its sha256

{
  "instructions": null,
  "tools": [
    {
      "description": "WRITE — adds a comment to an invoice (visible in its activity log). POST /invoice/{invoiceId}/comment.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "properties": {
          "invoiceId": {
            "description": "Invoice ID to comment on.",
            "type": "string"
          },
          "text": {
            "description": "Comment text.",
            "type": "string"
          },
          "userId": {
            "description": "ID or foreign ID of the user creating the comment.",
            "type": "string"
          }
        },
        "required": [
          "invoiceId",
          "text"
        ],
        "type": "object"
      },
      "name": "mercoa_add_invoice_comment",
      "outputSchema": null
    },
    {
      "description": "WRITE — creates a real entity (customer/vendor/payor/payee) in Mercoa. Supply role flags, accountType, and a nested `profile` object (business or individual details). POST /entity.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "properties": {
          "accountType": {
            "description": "business or individual.",
            "enum": [
              "business",
              "individual"
            ],
            "type": "string"
          },
          "email": {
            "description": "Primary email for the entity.",
            "type": "string"
          },
          "foreignId": {
            "description": "Your system's ID for this entity.",
            "type": "string"
          },
          "isCustomer": {
            "description": "Whether this entity has a direct relationship with your organization.",
            "type": "boolean"
          },
          "isPayee": {
            "description": "Whether this entity can receive payments (AR / vendor).",
            "type": "boolean"
          },
          "isPayor": {
            "description": "Whether this entity can pay invoices (AP).",
            "type": "boolean"
          },
          "profile": {
            "additionalProperties": {},
            "description": "Nested profile object, e.g. { \"business\": { \"legalBusinessName\": \"Acme Inc.\", \"email\": \"[email protected]\", \"businessType\": \"llc\" } } or { \"individual\": { \"name\": {...}, \"email\": \"...\" } }.",
            "propertyNames": {
              "type": "string"
            },
            "type": "object"
          }
        },
        "type": "object"
      },
      "name": "mercoa_create_entity",
      "outputSchema": null
    },
    {
      "description": "WRITE — creates a real invoice/bill in Mercoa. Set status (DRAFT to stage, NEW to submit), amount, currency, payer/vendor, dates and line items. POST /invoice.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "properties": {
          "amount": {
            "description": "Total invoice amount.",
            "type": "number"
          },
          "creatorEntityId": {
            "description": "Entity ID on whose behalf the invoice is created.",
            "type": "string"
          },
          "creatorUserId": {
            "description": "User ID creating the invoice.",
            "type": "string"
          },
          "currency": {
            "description": "Currency code, e.g. USD.",
            "type": "string"
          },
          "deductionDate": {
            "description": "Scheduled payment/deduction date (ISO 8601).",
            "type": "string"
          },
          "dueDate": {
            "description": "Due date (ISO 8601).",
            "type": "string"
          },
          "invoiceDate": {
            "description": "Invoice date (ISO 8601).",
            "type": "string"
          },
          "invoiceNumber": {
            "description": "Human-readable invoice number, e.g. INV-123.",
            "type": "string"
          },
          "lineItems": {
            "description": "Line items array, e.g. [{ \"amount\": 100, \"currency\": \"USD\", \"description\": \"Product A\", \"quantity\": 1, \"unitPrice\": 100 }].",
            "items": {
              "additionalProperties": {},
              "propertyNames": {
                "type": "string"
              },
              "type": "object"
            },
            "type": "array"
          },
          "metadata": {
            "additionalProperties": {},
            "description": "Arbitrary key/value metadata.",
            "propertyNames": {
              "type": "string"
            },
            "type": "object"
          },
          "noteToSelf": {
            "description": "Internal note.",
            "type": "string"
          },
          "payerId": {
            "description": "Payer entity ID (who owes).",
            "type": "string"
          },
          "paymentDestinationId": {
            "description": "Payment method ID to pay to (vendor's).",
            "type": "string"
          },
          "paymentSourceId": {
            "description": "Payment method ID to pay from (payer's).",
            "type": "string"
          },
          "status": {
            "description": "Invoice status, e.g. DRAFT, NEW, APPROVED, SCHEDULED.",
            "type": "string"
          },
          "vendorId": {
            "description": "Vendor entity ID (who is paid).",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "mercoa_create_invoice",
      "outputSchema": null
    },
    {
      "description": "Find/search entities (buyers, vendors, payors, payees). Use to look up counterparties by name/email/foreignId or list all. GET /entity.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "properties": {
          "foreignId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              }
            ],
            "description": "Your system's ID(s) for the entity."
          },
          "isCustomer": {
            "description": "If true, only entities with a direct relationship to your organization.",
            "type": "boolean"
          },
          "isPayee": {
            "description": "Filter entities marked as payees.",
            "type": "boolean"
          },
          "isPayor": {
            "description": "Filter entities marked as payors.",
            "type": "boolean"
          },
          "limit": {
            "description": "Max entities to return (1-100, default 10).",
            "exclusiveMinimum": 0,
            "maximum": 100,
            "type": "integer"
          },
          "paymentMethods": {
            "description": "If true, include payment methods in the response.",
            "type": "boolean"
          },
          "returnMetadata": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              }
            ],
            "description": "Metadata key(s) to include in the response."
          },
          "search": {
            "description": "Search by name, email, emailTo, entity ID, or foreign ID (partial matches).",
            "type": "string"
          },
          "startingAfter": {
            "description": "Entity ID cursor for pagination.",
            "type": "string"
          },
          "status": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              }
            ],
            "description": "Entity status filter (e.g. verified, pending)."
          }
        },
        "type": "object"
      },
      "name": "mercoa_find_entities",
      "outputSchema": null
    },
    {
      "description": "Find/search invoices (bills) across payers and vendors. Filter by status, entity, date, approver and more. GET /invoices (plural list endpoint).",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "properties": {
          "approverAction": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              }
            ],
            "description": "Filter by approver action (use with approverId), e.g. APPROVE."
          },
          "approverId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              }
            ],
            "description": "Filter by assigned approver user ID(s)."
          },
          "creatorUserId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              }
            ],
            "description": "Filter by the user ID(s) that created the invoice."
          },
          "dateType": {
            "description": "Date type to filter by (e.g. CREATED_AT, DUE_DATE).",
            "type": "string"
          },
          "endDate": {
            "description": "End date filter (ISO 8601).",
            "type": "string"
          },
          "entityGroupId": {
            "description": "Filter by entity group ID.",
            "type": "string"
          },
          "entityId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              }
            ],
            "description": "Filter by entity (payer or vendor) ID(s) or foreign ID(s)."
          },
          "invoiceId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              }
            ],
            "description": "Filter by invoice ID(s) or foreign ID(s)."
          },
          "invoiceTemplateId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              }
            ],
            "description": "Filter by invoice template ID(s)."
          },
          "limit": {
            "description": "Max invoices to return (1-100, default 10).",
            "exclusiveMinimum": 0,
            "maximum": 100,
            "type": "integer"
          },
          "orderBy": {
            "description": "Field to order by (e.g. CREATED_AT, AMOUNT, DUE_DATE).",
            "type": "string"
          },
          "orderDirection": {
            "description": "asc or desc.",
            "type": "string"
          },
          "payerId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              }
            ],
            "description": "Filter by payer ID(s) or foreign ID(s)."
          },
          "paymentType": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              }
            ],
            "description": "Filter by payment type (e.g. recurring)."
          },
          "returnPayerMetadata": {
            "description": "Include payer metadata in the response.",
            "type": "boolean"
          },
          "returnPaymentTiming": {
            "description": "Include payment timing in the response.",
            "type": "boolean"
          },
          "returnVendorMetadata": {
            "description": "Include vendor metadata in the response.",
            "type": "boolean"
          },
          "search": {
            "description": "Search by vendor name, invoice number, check number, or amount.",
            "type": "string"
          },
          "startDate": {
            "description": "Start date filter (ISO 8601).",
            "type": "string"
          },
          "startingAfter": {
            "description": "Invoice ID cursor for pagination.",
            "type": "string"
          },
          "status": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              }
            ],
            "description": "Invoice status filter (e.g. DRAFT, NEW, APPROVED, SCHEDULED, PAID)."
          },
          "vendorId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              }
            ],
            "description": "Filter by vendor ID(s) or foreign ID(s)."
          }
        },
        "type": "object"
      },
      "name": "mercoa_find_invoices",
      "outputSchema": null
    },
    {
      "description": "List/search payment transactions. Filter by entity, invoice, status, type and date. GET /transactions.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "properties": {
          "endDate": {
            "description": "CREATED_AT end date filter (ISO 8601).",
            "type": "string"
          },
          "entityGroupId": {
            "description": "Filter by entity group ID.",
            "type": "string"
          },
          "entityId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              }
            ],
            "description": "Filter by entity ID(s) or foreign ID(s)."
          },
          "invoiceId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              }
            ],
            "description": "Filter by invoice ID(s) or foreign ID(s)."
          },
          "limit": {
            "description": "Max transactions to return (1-100, default 10).",
            "exclusiveMinimum": 0,
            "maximum": 100,
            "type": "integer"
          },
          "payerId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              }
            ],
            "description": "Filter by payer ID(s)."
          },
          "search": {
            "description": "Search by vendor name, invoice number, check number, or amount.",
            "type": "string"
          },
          "startDate": {
            "description": "CREATED_AT start date filter (ISO 8601).",
            "type": "string"
          },
          "startingAfter": {
            "description": "Transaction ID cursor for pagination.",
            "type": "string"
          },
          "status": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              }
            ],
            "description": "Transaction status filter."
          },
          "transactionId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              }
            ],
            "description": "Filter by transaction ID(s)."
          },
          "transactionType": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              }
            ],
            "description": "Filter by transaction type."
          },
          "vendorId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              }
            ],
            "description": "Filter by vendor ID(s)."
          }
        },
        "type": "object"
      },
      "name": "mercoa_find_transactions",
      "outputSchema": null
    },
    {
      "description": "Get a single entity by ID (or foreign ID). GET /entity/{entityId}.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "properties": {
          "entityId": {
            "description": "Entity ID (e.g. ent_...) or foreign ID.",
            "type": "string"
          }
        },
        "required": [
          "entityId"
        ],
        "type": "object"
      },
      "name": "mercoa_get_entity",
      "outputSchema": null
    },
    {
      "description": "Get the event/audit log for an entity. GET /entity/{entityId}/events.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "properties": {
          "endDate": {
            "description": "End date filter (ISO 8601).",
            "type": "string"
          },
          "entityId": {
            "description": "Entity ID or foreign ID.",
            "type": "string"
          },
          "limit": {
            "description": "Max events to return (1-100).",
            "exclusiveMinimum": 0,
            "maximum": 100,
            "type": "integer"
          },
          "startDate": {
            "description": "Start date filter (ISO 8601).",
            "type": "string"
          },
          "startingAfter": {
            "description": "Event ID cursor for pagination.",
            "type": "string"
          }
        },
        "required": [
          "entityId"
        ],
        "type": "object"
      },
      "name": "mercoa_get_entity_events",
      "outputSchema": null
    },
    {
      "description": "Get aggregate invoice metrics (totals/counts, grouped by currency) for an entity's payables/receivables — for AP/AR dashboards and aging. GET /entity/{entityId}/invoice-metrics.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "properties": {
          "approverId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              }
            ],
            "description": "Filter by assigned approver user ID(s)."
          },
          "currency": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              }
            ],
            "description": "Currency code(s) to filter on, e.g. USD."
          },
          "dateType": {
            "description": "Date type to filter by (e.g. CREATED_AT, DUE_DATE).",
            "type": "string"
          },
          "endDate": {
            "description": "End date filter (ISO 8601).",
            "type": "string"
          },
          "entityId": {
            "description": "Entity ID or foreign ID.",
            "type": "string"
          },
          "excludePayables": {
            "description": "Only return receivables (exclude payables).",
            "type": "boolean"
          },
          "excludeReceivables": {
            "description": "Only return payables (exclude receivables).",
            "type": "boolean"
          },
          "groupBy": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              }
            ],
            "description": "Additional grouping (e.g. by status)."
          },
          "invoiceId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              }
            ],
            "description": "Filter by invoice ID(s) or foreign ID(s)."
          },
          "payerId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              }
            ],
            "description": "Filter by payer ID(s)."
          },
          "returnByDate": {
            "description": "Group metrics by date, e.g. CREATION_DATE or DUE_DATE.",
            "type": "string"
          },
          "returnByDateFrequency": {
            "description": "Frequency for date grouping (e.g. DAILY, MONTHLY).",
            "type": "string"
          },
          "search": {
            "description": "Search by vendor name, invoice number, check number, or amount.",
            "type": "string"
          },
          "startDate": {
            "description": "Start date filter (ISO 8601).",
            "type": "string"
          },
          "status": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              }
            ],
            "description": "Invoice status filter (e.g. NEW, SCHEDULED, PAID)."
          },
          "vendorId": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              }
            ],
            "description": "Filter by vendor ID(s)."
          }
        },
        "required": [
          "entityId"
        ],
        "type": "object"
      },
      "name": "mercoa_get_entity_invoice_metrics",
      "outputSchema": null
    },
    {
      "description": "Get a single invoice (bill) by ID. GET /invoice/{invoiceId}.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "properties": {
          "invoiceId": {
            "description": "Invoice ID (e.g. in_...) or foreign ID.",
            "type": "string"
          }
        },
        "required": [
          "invoiceId"
        ],
        "type": "object"
      },
      "name": "mercoa_get_invoice",
      "outputSchema": null
    },
    {
      "description": "Get the event/audit log for an invoice (status changes, approvals, payments). GET /invoice/{invoiceId}/events.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "properties": {
          "endDate": {
            "description": "End date filter (ISO 8601).",
            "type": "string"
          },
          "invoiceId": {
            "description": "Invoice ID or foreign ID.",
            "type": "string"
          },
          "limit": {
            "description": "Max events to return (1-100).",
            "exclusiveMinimum": 0,
            "maximum": 100,
            "type": "integer"
          },
          "startDate": {
            "description": "Start date filter (ISO 8601).",
            "type": "string"
          },
          "startingAfter": {
            "description": "Event ID cursor for pagination.",
            "type": "string"
          }
        },
        "required": [
          "invoiceId"
        ],
        "type": "object"
      },
      "name": "mercoa_get_invoice_events",
      "outputSchema": null
    },
    {
      "description": "Get the caller's Mercoa organization configuration (settings, payment methods enabled, etc.). GET /organization.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "properties": {},
        "type": "object"
      },
      "name": "mercoa_get_organization",
      "outputSchema": null
    },
    {
      "description": "Get a single payment method for an entity. GET /entity/{entityId}/paymentMethod/{paymentMethodId}.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "properties": {
          "entityId": {
            "description": "Entity ID or foreign ID.",
            "type": "string"
          },
          "paymentMethodId": {
            "description": "Payment method ID (e.g. pm_...).",
            "type": "string"
          }
        },
        "required": [
          "entityId",
          "paymentMethodId"
        ],
        "type": "object"
      },
      "name": "mercoa_get_payment_method",
      "outputSchema": null
    },
    {
      "description": "Get a single payment transaction by ID. GET /transaction/{transactionId}.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "properties": {
          "transactionId": {
            "description": "Transaction ID.",
            "type": "string"
          }
        },
        "required": [
          "transactionId"
        ],
        "type": "object"
      },
      "name": "mercoa_get_transaction",
      "outputSchema": null
    },
    {
      "description": "List an entity's payment methods (bank accounts, cards, check, etc.). GET /entity/{entityId}/paymentMethods.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "properties": {
          "entityId": {
            "description": "Entity ID or foreign ID.",
            "type": "string"
          },
          "type": {
            "description": "Filter by payment method type (e.g. bankAccount, card, check).",
            "type": "string"
          }
        },
        "required": [
          "entityId"
        ],
        "type": "object"
      },
      "name": "mercoa_list_entity_payment_methods",
      "outputSchema": null
    },
    {
      "description": "List the users belonging to an entity (approvers, admins, etc.). GET /entity/{entityId}/users.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "properties": {
          "entityId": {
            "description": "Entity ID or foreign ID.",
            "type": "string"
          }
        },
        "required": [
          "entityId"
        ],
        "type": "object"
      },
      "name": "mercoa_list_entity_users",
      "outputSchema": null
    },
    {
      "description": "WRITE — updates an existing invoice/bill (all fields optional). Commonly used to advance status (e.g. DRAFT→NEW→SCHEDULED) or change amounts, dates, or payment methods. POST /invoice/{invoiceId}.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "properties": {
          "amount": {
            "description": "Total invoice amount.",
            "type": "number"
          },
          "currency": {
            "description": "Currency code, e.g. USD.",
            "type": "string"
          },
          "deductionDate": {
            "description": "Scheduled payment/deduction date (ISO 8601).",
            "type": "string"
          },
          "dueDate": {
            "description": "Due date (ISO 8601).",
            "type": "string"
          },
          "invoiceDate": {
            "description": "Invoice date (ISO 8601).",
            "type": "string"
          },
          "invoiceId": {
            "description": "Invoice ID to update.",
            "type": "string"
          },
          "invoiceNumber": {
            "description": "Human-readable invoice number.",
            "type": "string"
          },
          "lineItems": {
            "description": "Replacement line items array.",
            "items": {
              "additionalProperties": {},
              "propertyNames": {
                "type": "string"
              },
              "type": "object"
            },
            "type": "array"
          },
          "metadata": {
            "additionalProperties": {},
            "description": "Arbitrary key/value metadata.",
            "propertyNames": {
              "type": "string"
            },
            "type": "object"
          },
          "noteToSelf": {
            "description": "Internal note.",
            "type": "string"
          },
          "payerId": {
            "description": "Payer entity ID.",
            "type": "string"
          },
          "paymentDestinationId": {
            "description": "Payment method ID to pay to.",
            "type": "string"
          },
          "paymentSourceId": {
            "description": "Payment method ID to pay from.",
            "type": "string"
          },
          "status": {
            "description": "New invoice status, e.g. NEW, APPROVED, SCHEDULED.",
            "type": "string"
          },
          "vendorId": {
            "description": "Vendor entity ID.",
            "type": "string"
          }
        },
        "required": [
          "invoiceId"
        ],
        "type": "object"
      },
      "name": "mercoa_update_invoice",
      "outputSchema": null
    }
  ]
}

Verify it yourself

curl -s https://api.teppi.xyz/v1/evidence/sha256:d603dc4d7664f460943d328b40e98ec5119bd5f420fbeb1d403a8bcfca6cb9b4 | sha256sum