Adding iRancho as an MCP
Before you start, make sure the MCP Server is set up. See MCPs for how MCPs work.- Go to Activate → MCPs, click New MCP and choose iRancho.
- Name your MCP and describe what it is used for. The agent reads the description to choose between MCPs of the same provider.
- Setup access. To connect, you need an integration token from iRancho.
- Log into your iRancho account.
- Navigate to your account settings to find or generate your integration token.
- Fill in the following field in Nekt:
- Api Token: Token de integração gerado nas configurações da conta no iRancho (enviado no header x-access-token-ws). (Required)
- Select tools. Pick the tools your agents can use. See Available tools below.
- Click Save. On Growth and Custom plans, choose who can use it; see Access levels.
Example prompts
- “Find the animal with the farm ID 998877.”
- “List all the stock locations we have configured in our account.”
- “Check if the supplier with CNPJ 12345678000199 exists. If they don’t, register them as ‘Agro Supplies’.”
- “Register a new product called ‘Premium Cattle Feed’ in the system and give me its new ID.”
- “Record a stock entry for the purchase of items on invoice number 5544 from our supplier, placing them into the main warehouse.”
Available tools
Choose which of these tools your agents can use in Select tools.What changed in v1.1. Added:
alterar_produto, incluir_fornecedor, incluir_produto, registrar_entrada_estoque. Updated: buscar_entrada_estoque, buscar_pessoa_por_documento, buscar_produto, listar_categorias_produto, listar_embalagens, listar_estoques, listar_unidades_medida. Removed: atualizar_produto, criar_entrada_estoque, criar_fornecedor, criar_produto.Read tools
Write tools
Troubleshooting
- Revoked or expired token: If your integration token is regenerated or deleted in iRancho, the MCP will show that it needs to reconnect. Go to the MCP’s page in Nekt and update the token to restore access.
- Write operation failures: Adding products or recording stock entries requires exact internal IDs for categories, units of measure, and storage locations. If the agent cannot find a matching configuration in your account, it will fail to save the record. Ensure your iRancho account has the necessary categories and locations set up.