Skip to content

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

  1. A company admin switches on API & Integrations in ENTEK Corporate Settings. It is off by default.
  2. Generate an access token there. ENTEK Supplier users generate an MCP token the same way.
  3. Add the server to your assistant with the token.

REST, for your systems

  1. Write to [email protected] with your company name and use case.
  2. We share your key, the base URL and rate limits.
  3. Make your first call, as shown below.

Authentication#

Send the credential with every request.

HTTP · example
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:

MethodPathWhat it does
GET/api/productsRetrieve a list of available products.
POST/api/ordersPlace a new order through the API.
cURL · example
# 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.

  1. Your assistantAny MCP client
  2. ENTEK MCP servermcp.corporate.entek.ai
  3. Access checkYour role, your company
  4. ENTEK CorporateOrders, RFQs, branches

Connect in four steps

  1. Switch on API & Integrations. A company admin turns it on in ENTEK Corporate Settings. It is off by default for new companies.
  2. 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.
  3. Add the server to your client. Paste the server address and the token into your MCP client, as in the example below.
  4. Check the connection. Ask "who am I connected as?". The client calls whoami and shows your company. Then try "list our branches".
MCP client config · example
{
  "mcpServers": {
    "entek-corporate": {
      "url": "https://mcp.corporate.entek.ai",
      "headers": { "Authorization": "Bearer <your-token>" }
    }
  }
}
tools/call · example
list_orders { "branch_id": "<id from list_branches>", "status": "shipped" }
// runs with the token owner's permissions

How 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_orders
  • get_order
  • preview_order
  • place_orderWriteMoves money
  • cancel_orderWrite
  • get_order_metrics
  • get_order_charts
  • get_order_logistics
  • get_order_delivery_proof
  • send_order_proof_codeWrite

RFQs and bids

  • list_rfqs
  • get_rfq
  • create_rfqWrite
  • list_rfq_bids
  • get_bid
  • decide_bid_iterationWriteMoves money
  • get_rfq_metrics
  • create_purchase_orderWrite
  • list_rfq_purchase_orders

Marketplace and catalogue

  • search_marketplace_products
  • get_catalog_product
  • list_catalog_products
  • list_stores
  • preview_marketplace_order
  • place_marketplace_orderWriteMoves money

Branches

  • list_branches
  • get_branch
  • create_branchWrite
  • update_branchWrite
  • get_branch_metrics
  • list_branch_memberships

Suppliers

  • list_supplier_companies
  • get_supplier_company
  • list_supplier_favorites
  • create_supplier_favoritesWrite
  • list_supplier_invites

Finance

  • get_company_balance
  • get_company_limits
  • pay_order_with_balanceWriteMoves money
  • generate_order_payment_linkWriteMoves money
  • get_order_billing

Recurring orders

  • list_recurrences
  • create_recurrenceWrite
  • update_recurrenceWrite
  • get_recurrence_metrics

Company, users and roles

  • whoami
  • get_company_profile
  • list_company_users
  • list_roles
  • get_my_role

Building an integration?

Tell us what you want to connect. Our team replies in Arabic or English.