eGestor MCP by usefulapi
Read contacts, products, sales, receivables and payables; create contacts in eGestor.
¿Debería usar esto?
Calidad y seguridad
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"egestor": {
"url": "https://egestor.usefulapi.io/mcp"
}
}
}Puntos de conexión remotos
https://egestor.usefulapi.io/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (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.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Comunidad
Evidencia