eGestor MCP by usefulapi
Read contacts, products, sales, receivables and payables; create contacts in eGestor.
我該用這個嗎
品質與安全性
根據工具定義與協定合規性的自動化分析。
上下文成本
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高,可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案:
{
"mcpServers": {
"egestor": {
"url": "https://egestor.usefulapi.io/mcp"
}
}
}遠端端點
https://egestor.usefulapi.io/mcpstreamable-http它能做什麼
工具清單
工具(18)
🟢egestor_list_contacts(filtro, page, orderBy, tipo, fields)
List customers, suppliers and carriers. Good first call to find a contact code. eGestor API: GET /v1/contatos.
輸入結構描述
{
"type": "object",
"properties": {
"filtro": {
"description": "Text search over the main fields of the record.",
"type": "string"
},
"page": {
"description": "Page number (default 1, 50 rows per page).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"orderBy": {
"description": "Sort as \"field,asc\" or \"field,desc\".",
"type": "string"
},
"tipo": {
"description": "Only this kind of contact.",
"type": "string",
"enum": [
"cliente",
"fornecedor",
"transportadora"
]
},
"fields": {
"description": "Comma-separated list of fields to return.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢egestor_get_contact(codigo)
Get full data of one contact by code. eGestor API: GET /v1/contatos/{codigo}.
輸入結構描述
{
"type": "object",
"properties": {
"codigo": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The record code (from the matching list tool)."
}
},
"required": [
"codigo"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴egestor_create_contact(nome, fantasia, tipo, cpfcnpj, emails, ...)
Create a new contact (customer, supplier or carrier) in eGestor. This writes data and is not idempotent: calling it twice creates two contacts. Returns the new code. eGestor API: POST /v1/contatos.
輸入結構描述
{
"type": "object",
"properties": {
"nome": {
"type": "string",
"minLength": 1,
"description": "Full name or company name."
},
"fantasia": {
"description": "Trade name.",
"type": "string"
},
"tipo": {
"minItems": 1,
"type": "array",
"items": {
"type": "string",
"enum": [
"cliente",
"fornecedor",
"transportadora"
]
},
"description": "Contact kinds."
},
"cpfcnpj": {
"description": "CPF or CNPJ, digits only.",
"type": "string"
},
"emails": {
"description": "Email addresses.",
"type": "array",
"items": {
"type": "string"
}
},
"fones": {
"description": "Phone numbers, digits only.",
"type": "array",
"items": {
"type": "string"
}
},
"cep": {
"description": "Postal code (CEP), digits only.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"logradouro": {
"description": "Street.",
"type": "string"
},
"numero": {
"description": "Street number.",
"type": "string"
},
"uf": {
"description": "State code, 2 letters.",
"type": "string",
"minLength": 2,
"maxLength": 2
}
},
"required": [
"nome",
"tipo"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢egestor_list_products(filtro, page, orderBy, fields)
List products with prices and stock data. eGestor API: GET /v1/produtos.
輸入結構描述
{
"type": "object",
"properties": {
"filtro": {
"description": "Text search over the main fields of the record.",
"type": "string"
},
"page": {
"description": "Page number (default 1, 50 rows per page).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"orderBy": {
"description": "Sort as \"field,asc\" or \"field,desc\".",
"type": "string"
},
"fields": {
"description": "Comma-separated list of fields to return.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢egestor_get_product(codigo)
Get full data of one product by code. eGestor API: GET /v1/produtos/{codigo}.
輸入結構描述
{
"type": "object",
"properties": {
"codigo": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The record code (from the matching list tool)."
}
},
"required": [
"codigo"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢egestor_list_services(filtro, page, orderBy)
List services the company sells. eGestor API: GET /v1/servicos.
輸入結構描述
{
"type": "object",
"properties": {
"filtro": {
"description": "Text search over the main fields of the record.",
"type": "string"
},
"page": {
"description": "Page number (default 1, 50 rows per page).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"orderBy": {
"description": "Sort as \"field,asc\" or \"field,desc\".",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢egestor_list_sales(filtro, page, orderBy, dtIni, dtFim, ...)
List sales (situacao 10 = quote, 50 = sale), filterable by date range and contact. eGestor API: GET /v1/vendas.
輸入結構描述
{
"type": "object",
"properties": {
"filtro": {
"description": "Text search over the main fields of the record.",
"type": "string"
},
"page": {
"description": "Page number (default 1, 50 rows per page).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"orderBy": {
"description": "Sort as \"field,asc\" or \"field,desc\".",
"type": "string"
},
"dtIni": {
"description": "Start date yyyy-mm-dd.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"dtFim": {
"description": "End date yyyy-mm-dd.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"dtTipo": {
"description": "Which date field dtIni/dtFim filter on.",
"type": "string",
"enum": [
"dtVenda",
"dtCad",
"dtEntrega"
]
},
"situacao": {
"description": "10 = quote, 50 = sale.",
"anyOf": [
{
"type": "number",
"const": 10
},
{
"type": "number",
"const": 50
}
]
},
"codContato": {
"description": "Only sales of this contact code.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"fields": {
"description": "Comma-separated list of fields to return.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢egestor_get_sale(codigo, listarCanceladas)
Get full data of one sale: items, payments, totals. eGestor API: GET /v1/vendas/{codigo}.
輸入結構描述
{
"type": "object",
"properties": {
"codigo": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The record code (from the matching list tool)."
},
"listarCanceladas": {
"description": "Include cancelled sales.",
"type": "boolean"
}
},
"required": [
"codigo"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢egestor_list_receivables(filtro, page, orderBy, dtIni, dtFim, ...)
List accounts receivable (situacao 20 = open, 40 = received), filterable by date range. eGestor API: GET /v1/recebimentos.
輸入結構描述
{
"type": "object",
"properties": {
"filtro": {
"description": "Text search over the main fields of the record.",
"type": "string"
},
"page": {
"description": "Page number (default 1, 50 rows per page).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"orderBy": {
"description": "Sort as \"field,asc\" or \"field,desc\".",
"type": "string"
},
"dtIni": {
"description": "Start date yyyy-mm-dd.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"dtFim": {
"description": "End date yyyy-mm-dd.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"situacao": {
"description": "20 = open, 40 = received.",
"anyOf": [
{
"type": "number",
"const": 20
},
{
"type": "number",
"const": 40
}
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢egestor_get_receivable(codigo)
Get one receivable by code. eGestor API: GET /v1/recebimentos/{codigo}.
輸入結構描述
{
"type": "object",
"properties": {
"codigo": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The record code (from the matching list tool)."
}
},
"required": [
"codigo"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢egestor_list_payables(filtro, page, orderBy, dtIni, dtFim, ...)
List accounts payable (situacao 10 = open, 30 = paid), filterable by date range. eGestor API: GET /v1/pagamentos.
輸入結構描述
{
"type": "object",
"properties": {
"filtro": {
"description": "Text search over the main fields of the record.",
"type": "string"
},
"page": {
"description": "Page number (default 1, 50 rows per page).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"orderBy": {
"description": "Sort as \"field,asc\" or \"field,desc\".",
"type": "string"
},
"dtIni": {
"description": "Start date yyyy-mm-dd.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"dtFim": {
"description": "End date yyyy-mm-dd.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"situacao": {
"description": "10 = open, 30 = paid.",
"anyOf": [
{
"type": "number",
"const": 10
},
{
"type": "number",
"const": 30
}
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢egestor_get_payable(codigo)
Get one payable by code. eGestor API: GET /v1/pagamentos/{codigo}.
輸入結構描述
{
"type": "object",
"properties": {
"codigo": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The record code (from the matching list tool)."
}
},
"required": [
"codigo"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢egestor_list_purchases(filtro, page, orderBy, dtIni, dtFim, ...)
List purchases (situacao 10 = quote, 50 = confirmed), filterable by date range. eGestor API: GET /v1/compras.
輸入結構描述
{
"type": "object",
"properties": {
"filtro": {
"description": "Text search over the main fields of the record.",
"type": "string"
},
"page": {
"description": "Page number (default 1, 50 rows per page).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"orderBy": {
"description": "Sort as \"field,asc\" or \"field,desc\".",
"type": "string"
},
"dtIni": {
"description": "Start date yyyy-mm-dd.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"dtFim": {
"description": "End date yyyy-mm-dd.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"dtTipo": {
"description": "Which date field dtIni/dtFim filter on.",
"type": "string",
"enum": [
"dtCompra",
"dtCad"
]
},
"situacao": {
"description": "10 = quote, 50 = confirmed.",
"anyOf": [
{
"type": "number",
"const": 10
},
{
"type": "number",
"const": 50
}
]
},
"nota": {
"description": "Filter by invoice number.",
"type": "string"
},
"fields": {
"description": "Comma-separated list of fields to return.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢egestor_get_purchase(codigo)
Get full data of one purchase. eGestor API: GET /v1/compras/{codigo}.
輸入結構描述
{
"type": "object",
"properties": {
"codigo": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The record code (from the matching list tool)."
}
},
"required": [
"codigo"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢egestor_list_accounts(filtro, page, orderBy)
List cash boxes and bank accounts (disponiveis). eGestor API: GET /v1/disponiveis.
輸入結構描述
{
"type": "object",
"properties": {
"filtro": {
"description": "Text search over the main fields of the record.",
"type": "string"
},
"page": {
"description": "Page number (default 1, 50 rows per page).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"orderBy": {
"description": "Sort as \"field,asc\" or \"field,desc\".",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢egestor_list_categories(filtro, page, orderBy)
List product and finance categories. eGestor API: GET /v1/categorias.
輸入結構描述
{
"type": "object",
"properties": {
"filtro": {
"description": "Text search over the main fields of the record.",
"type": "string"
},
"page": {
"description": "Page number (default 1, 50 rows per page).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"orderBy": {
"description": "Sort as \"field,asc\" or \"field,desc\".",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢egestor_list_users(filtro, page, orderBy, vendedor, fields)
List users and sales people of the account. eGestor API: GET /v1/usuarios.
輸入結構描述
{
"type": "object",
"properties": {
"filtro": {
"description": "Text search over the main fields of the record.",
"type": "string"
},
"page": {
"description": "Page number (default 1, 50 rows per page).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"orderBy": {
"description": "Sort as \"field,asc\" or \"field,desc\".",
"type": "string"
},
"vendedor": {
"description": "true = only sales people.",
"type": "boolean"
},
"fields": {
"description": "Comma-separated list of fields to return.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢egestor_get_company
Get the registration data of the company that owns the token. eGestor API: GET /v1/empresa.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}社群
證據