Integrations
The Buyamia Directory offers three integration methods depending on your use case. Choose the one that best fits your system architecture.
Integration Methods
| Method | Best For | Protocol |
|---|---|---|
REST API (/v1/*) | Traditional backend integration, CRUD operations | HTTP REST + JSON |
| Agent Gateway | AI agents, chatbots, natural language queries | HTTP POST + JSON |
| MCP Server | AI assistants (Claude, ChatGPT), tool-calling agents | MCP Streamable HTTP |
Comparison
| Feature | REST API | Agent Gateway | MCP Server |
|---|---|---|---|
| Auth | X-API-Key | X-API-Key or Supabase Auth | X-API-Key |
| Query format | Structured (params/JSON) | Natural language | Tool calls (JSON-RPC) |
| Response | Raw data | AI-processed + structured | Tool results |
| Semantic search | Via /v1/semantic-search | Built-in | Built-in |
| Best for | Developers | AI agents | AI assistants |
If you're building a procurement AI agent, start with the Agent Gateway for quick natural language queries, then move to the MCP Server for deeper tool-based integration.
Last updated on March 15, 2026