- RFQs with approvers, multi-round bids, PO on award
- Marketplace in 12 categories and 320+ Saudi suppliers
- Live delivery map, proof of delivery, VAT invoices
Developers
API Documentation
REST endpoints for your systems and MCP tools for your AI assistants. Every call is scoped to your company and your permissions.
Which should I use?#
Two ways in. Both run with the permissions of the person who issued the credential.
Quickstart#
MCP, for AI assistants
- A company admin switches on API & Integrations in ENTEK Corporate Settings. It is off by default.
- Generate an access token there. ENTEK Supplier users generate an MCP token the same way.
- Add the server to your assistant with the token.
REST, for your systems
- Write to [email protected] with your company name and use case.
- We share your key, the base URL and rate limits.
- Make your first call, as shown below.
Authentication#
Send the credential with every request.
Authorization: Bearer <your-token>A token can do only what the person who issued it can do in the app. Store it like a password, and revoke it in Settings if it leaks.
REST endpoints#
Endpoints available today:
| Method | Path | What it does |
|---|---|---|
| GET | /api/products | Retrieve a list of available products. |
| POST | /api/orders | Place a new order through the API. |
# list products
curl https://<base-url>/api/products \
-H "Authorization: Bearer <your-key>"- Base URL
- Shared with your key
- Rate limits
- Shared with your key
- Request body for POST /api/orders
- Shared with your key
- Errors and versioning
- Shared with your key
MCP server#
One connection gives your assistant the same view of ENTEK that you have in the app. Here is what happens on every request.
- Your assistantAny MCP client
- ENTEK MCP servermcp.corporate.entek.ai
- Access checkYour role, your company
- ENTEK CorporateOrders, RFQs, branches
Connect in four steps
- Switch on API & Integrations. A company admin turns it on in ENTEK Corporate Settings. It is off by default for new companies.
- Generate a token. The token carries your role, so the assistant can never do more than you can. Name it after the tool that will use it.
- Add the server to your client. Paste the server address and the token into your MCP client, as in the example below.
- Check the connection. Ask "who am I connected as?". The client calls whoami and shows your company. Then try "list our branches".
{
"mcpServers": {
"entek-corporate": {
"url": "https://mcp.corporate.entek.ai",
"headers": { "Authorization": "Bearer <your-token>" }
}
}
}list_orders { "branch_id": "<id from list_branches>", "status": "shipped" }
// runs with the token owner's permissionsHow the server behaves
- One company per token. Every call is limited to the company and the role the token belongs to.
- Lists come one page at a time with next_cursor and has_more. One page is never the whole set.
- Counts and totals come from metric tools computed by the platform, not from adding up a page.
- Amounts always carry their currency and are never mixed across currencies.
- Revoke a token in Settings and every client using it stops at once.
Host: mcp.corporate.entek.ai. Confirm the exact path and header format with [email protected] before going live.
Tools by area#
50 tools on the ENTEK Corporate MCP server. Write tools change real data, so give them only to people who may do that in the app.
Orders
list_ordersget_orderpreview_orderplace_orderWriteMoves moneycancel_orderWriteget_order_metricsget_order_chartsget_order_logisticsget_order_delivery_proofsend_order_proof_codeWrite
RFQs and bids
list_rfqsget_rfqcreate_rfqWritelist_rfq_bidsget_biddecide_bid_iterationWriteMoves moneyget_rfq_metricscreate_purchase_orderWritelist_rfq_purchase_orders
Marketplace and catalogue
search_marketplace_productsget_catalog_productlist_catalog_productslist_storespreview_marketplace_orderplace_marketplace_orderWriteMoves money
Branches
list_branchesget_branchcreate_branchWriteupdate_branchWriteget_branch_metricslist_branch_memberships
Suppliers
list_supplier_companiesget_supplier_companylist_supplier_favoritescreate_supplier_favoritesWritelist_supplier_invites
Finance
get_company_balanceget_company_limitspay_order_with_balanceWriteMoves moneygenerate_order_payment_linkWriteMoves moneyget_order_billing
Recurring orders
list_recurrencescreate_recurrenceWriteupdate_recurrenceWriteget_recurrence_metrics
Company, users and roles
whoamiget_company_profilelist_company_userslist_rolesget_my_role
Building an integration?
Tell us what you want to connect. Our team replies in Arabic or English.

