MCP
MCP server and tools
https://midgardindustrial.aramous.com/api/mcp, over Streamable HTTP. Searching needs no sign-in. To order, the agent calls sign_inwith the person's email, asks them for the six-digit code from the email, then calls verify_code. Or connect with an API key in the Authorization header.
claude mcp add --transport http midgard-industrial https://midgardindustrial.aramous.com/api/mcp claude mcp add --transport http midgard-science https://midgardscience.aramous.com/api/mcp
npx @modelcontextprotocol/inspector --cli https://midgardindustrial.aramous.com/api/mcp --transport http --method tools/list
Cursor, VS Code and other clients: configuration. Each tool carries the MCP annotations readOnlyHint, destructiveHint, idempotentHint and openWorldHint. A tool error is a result with isError and the text {"error": {"code", "message"}}.
list_categories
List categories
- No sign-in
- Read-only
Lists each site ("science", "industrial"), its service categories and the spec fields a request in each category takes, marking the required ones. Call it before create_request to get a valid site, category and spec keys. No sign-in needed.
{}Returns the same object as GET /api/v1/categories, as JSON text.
readOnlyHint true, destructiveHint false, idempotentHint true, openWorldHint false
Errors
- 500server_errorSomething failed on the server; try again.
search_suppliers
Search the directory
- No sign-in
- Read-only
Keyword search of the public supplier directory, the same search as the website. Returns a page of listings with location, categories, certificates and services. Use it to browse or to apply exact filters: category, state or province, certificate, purchase orders. For work described in plain language and ranked by fit, use find_suppliers. No sign-in needed.
Arguments
- q stringWords to search for.
- site stringThe site: "science" or "industrial". Defaults to the site this address serves.
- category stringA category slug from list_categories.
- region stringA state or province code as listings give it, e.g. CA or OH.
- cert stringA certificate or standard, e.g. ISO 9001.
- accepts_po booleanOnly suppliers that take purchase orders.
- page integer
- per_page integer
{
"category": "cnc-machining",
"q": "aluminum",
"per_page": 5
}Returns the same object as GET /api/v1/suppliers, as JSON text.
readOnlyHint true, destructiveHint false, idempotentHint true, openWorldHint false
Errors
- 400invalid_requestUnknown site, or a category of another site.
- 500server_errorSomething failed on the server; try again.
find_suppliers
Find suppliers for a request
- No sign-in
- Read-only
The first call for "find a lab, CRO, shop or supplier for this work". Describe the work in plain language; returns up to 10 suppliers ranked by fit, each with the reasons taken from its profile, and a request_draft to pass to create_request once the person has checked it. missing lists details still needed before ordering. Takes up to a minute. No sign-in needed: 10 searches an hour per network address, 100 an hour when signed in.
Arguments
- query string, requiredThe work, in the person's words: what, how many, any standards and deadlines.
- site stringThe site: "science" or "industrial". Defaults to the site this address serves.
- category stringA category slug from list_categories.
- region "any" | "na" | "us" | "eu" | "india" | "asia"Region key: any, na, us, eu, india, asia. "eu" includes the UK.
- standard stringA quality standard the supplier must hold, e.g. GLP or ISO 13485.
- limit integerHow many suppliers, 1 to 10. Default 8.
{
"query": "50 anodized 6061 aluminum brackets, CNC machined from a STEP file, +/-0.05 mm",
"limit": 3
}Returns the same object as POST /api/v1/search, as JSON text.
readOnlyHint true, destructiveHint false, idempotentHint true, openWorldHint false
Errors
- 400invalid_requestUnknown site, category or region.
- 429rate_limitedOver the hourly search limit.
- 500server_errorSomething failed on the server; try again.
get_supplier
Get a supplier
- No sign-in
- Read-only
One listing by slug (from find_suppliers or search_suppliers): profile, services and listed prices, standards, public records, shared contact mailboxes, and ways to continue: contact the supplier directly, or ask for a quote through a request. No sign-in needed.
Arguments
- slug string, requiredThe supplier's slug, from a search.
{
"slug": "example-machine-works"
}Returns the same object as GET /api/v1/suppliers/{slug}, as JSON text.
readOnlyHint true, destructiveHint false, idempotentHint true, openWorldHint false
Errors
- 404not_foundNo listed supplier with that slug.
- 500server_errorSomething failed on the server; try again.
sign_in
Sign in: send a code
- No sign-in
- Adds, does not overwrite
- Not safe to repeat
- Reaches email or suppliers
Step 1 of signing in, needed only to order or read orders. Emails a six-digit code to the person's own address: ask them for it and never guess it. Then ask them for the code and call verify_code. Orders are placed for, and visible to, this address. Each call sends another email; the two newest codes work. Not needed when the connection sends an API key.
Arguments
- email string, requiredThe person's email address.
{
"email": "you@company.com"
}Returns the same object as POST /api/v1/auth/code, as JSON text.
readOnlyHint false, destructiveHint false, idempotentHint false, openWorldHint true
Errors
- 400no_sessionThe client keeps no Mcp-Session-Id, so it cannot hold a sign-in; connect with an API key instead.
- 400invalid_requestNot an email address.
- 429rate_limitedToo many codes from this network, or for this address.
- 500server_errorSomething failed on the server; try again.
verify_code
Sign in: check the code
- No sign-in
- Adds, does not overwrite
- Not safe to repeat
- Stays on the server
Step 2 of signing in: checks the six-digit code the person read from the email sent by sign_in, and signs this connection in as that email. The code works once, for 10 minutes, with 5 tries.
Arguments
- email string, requiredThe same email as in sign_in.
- code string or integer, requiredThe six-digit code the person read from the email.
{
"email": "you@company.com",
"code": "123456"
}Returns {"signed_in": true, "email", "message"} as JSON text; the session is signed in and no key is returned.
readOnlyHint false, destructiveHint false, idempotentHint false, openWorldHint false
Errors
- 400no_sessionThe client keeps no Mcp-Session-Id.
- 400invalid_codeThe code is wrong.
- 400code_expiredExpired or used; call sign_in again.
- 429too_many_triesToo many wrong codes for this address.
- 500server_errorSomething failed on the server; try again.
whoami
Who is signed in
- Needs sign-in
- Read-only
The email this connection acts for, and the key in use. Use it to check the sign-in before ordering.
{}Returns the same object as GET /api/v1/me, as JSON text.
readOnlyHint true, destructiveHint false, idempotentHint true, openWorldHint false
Errors
- 401sign_in_requiredNot signed in: call sign_in and verify_code, or connect with an API key.
- 500server_errorSomething failed on the server; try again.
create_request
Create a request
- Needs sign-in
- Adds, does not overwrite
- Not safe to repeat
- Reaches email or suppliers
Places a request for quotes as the signed-in email, on a site and category from list_categories. A request_draft from find_suppliers is a good start; check the details with the person first. The request starts as new with suggested suppliers, and nothing goes to any supplier until request_action confirm_labs. suppliers only pre-selects slugs (an unknown slug is refused); they are asked when you run confirm_labs. Returns the request and a status_url the person can open. Send idempotency_key so a retry returns the same request.
Arguments
- site string, requiredThe site: "science" or "industrial".
- category string, requiredA category slug from list_categories.
- title string, requiredA short title for the work.
- spec objectThe category's spec fields, key to value (see list_categories).
- quantity integer
- details stringAnything else the suppliers should know.
- needed_by stringA date, e.g. 2027-01-15.
- budget string
- supplier stringOne preferred supplier slug.
- suppliers array of stringSupplier slugs to pre-select. Nobody is asked until confirm_labs.
- contact_name string
- organization string
- country string
- idempotency_key stringSend the same value on a retry to get the request already created instead of a second one.
{
"site": "industrial",
"category": "cnc-machining",
"title": "50 anodized 6061 aluminum brackets",
"spec": {
"material": "6061-T6 aluminum",
"finish": "anodized black",
"export_control": "No controlled data"
},
"quantity": 50,
"needed_by": "2027-01-15",
"idempotency_key": "my-order-123"
}Returns the same object as POST /api/v1/requests, as JSON text.
readOnlyHint false, destructiveHint false, idempotentHint false, openWorldHint true
Errors
- 401sign_in_requiredNot signed in: call sign_in and verify_code, or connect with an API key.
- 400invalid_requestUnknown site or category, a missing required field or a placeholder value.
- 500server_errorSomething failed on the server; try again.
list_requests
List requests
- Needs sign-in
- Read-only
The signed-in email's requests, newest first, including orders placed on the website. Filter by status to find the ones waiting on the person (quoted, delivered).
Arguments
- status stringOne status or several, comma-separated: new, sourcing, quoted, accepted, paid, in_progress, delivered, closed, cancelled, introduced.
- site stringThe site: "science" or "industrial". Defaults to the site this address serves.
- limit integerDefault 20.
- starting_after stringTo page: the last id of the previous page.
{
"status": "quoted,delivered",
"limit": 20
}Returns the same object as GET /api/v1/requests, as JSON text.
readOnlyHint true, destructiveHint false, idempotentHint true, openWorldHint false
Errors
- 401sign_in_requiredNot signed in: call sign_in and verify_code, or connect with an API key.
- 400invalid_requestUnknown status or site, or a starting_after id that is not yours.
- 500server_errorSomething failed on the server; try again.
get_request
Get a request
- Needs sign-in
- Read-only
One request: status, suggested suppliers (supplier_id for confirm_labs), quotes (each with its id for accept_quote and its ways to continue), milestones, payments, shipments, files and the public timeline. Check it again later to see when status becomes quoted.
Arguments
- request_id string, requiredThe request id (req_...).
{
"request_id": "req_Xq3v9KpL2aB7"
}Returns the same object as GET /api/v1/requests/{id}, as JSON text.
readOnlyHint true, destructiveHint false, idempotentHint true, openWorldHint false
Errors
- 401sign_in_requiredNot signed in: call sign_in and verify_code, or connect with an API key.
- 404not_foundNo request with that id for this account.
- 500server_errorSomething failed on the server; try again.
get_messages
Read messages
- Needs sign-in
- Read-only
The message thread on a request, oldest first: what the person sent ("you") and the updates and supplier questions passed on to them ("midgard").
Arguments
- request_id string, requiredThe request id (req_...).
{
"request_id": "req_Xq3v9KpL2aB7"
}Returns the same object as GET /api/v1/requests/{id}/messages, as JSON text.
readOnlyHint true, destructiveHint false, idempotentHint true, openWorldHint false
Errors
- 401sign_in_requiredNot signed in: call sign_in and verify_code, or connect with an API key.
- 404not_foundNo request with that id for this account.
- 500server_errorSomething failed on the server; try again.
send_message
Send a message
- Needs sign-in
- Adds, does not overwrite
- Not safe to repeat
- Reaches email or suppliers
Adds a message to a request's thread: an answer to a supplier's question, or more detail. It is passed on. Each call adds another message.
Arguments
- request_id string, requiredThe request id (req_...).
- message string, required
{
"request_id": "req_Xq3v9KpL2aB7",
"message": "Samples ship on Monday."
}Returns the same object as POST /api/v1/requests/{id}/messages, as JSON text.
readOnlyHint false, destructiveHint false, idempotentHint false, openWorldHint true
Errors
- 401sign_in_requiredNot signed in: call sign_in and verify_code, or connect with an API key.
- 404not_foundNo request with that id for this account.
- 500server_errorSomething failed on the server; try again.
accept_quote
Accept a quote
- Needs sign-in
- Cannot be undone
- Not safe to repeat
- Reaches email or suppliers
Accepts a quote the way the person chose; it cannot be undone, so confirm with them first. continue "midgard" keeps the order on the site under the order terms: terms_name must be the full name the person typed to accept the terms; ask them for it and never fill it in yourself. The answer may carry payment_url, a Stripe Checkout link for the person to open and pay; you cannot pay. continue "own" takes the quote to the supplier directly; the supplier's contact details then appear on the timeline.
Arguments
- quote_id string, requiredThe quote id (qt_...), from get_request.
- continue "midgard" | "own", requiredHow the person continues.
- terms_name stringFor "midgard": the name the person typed to accept the order terms.
- po stringA purchase order number. With one, payments are invoiced.
- billing_email stringWhere invoices go, if not the signed-in email.
- revision stringParts: the file revision the order is built to, e.g. Rev C.
{
"quote_id": "qt_Hn4sD8wQ1zR6",
"continue": "midgard",
"terms_name": "<the name the person typed>"
}Returns the same object as POST /api/v1/quotes/{id}/accept, as JSON text.
readOnlyHint false, destructiveHint true, idempotentHint false, openWorldHint true
Errors
- 401sign_in_requiredNot signed in: call sign_in and verify_code, or connect with an API key.
- 404not_foundNo quote with that id.
- 400invalid_requestNo terms_name for "midgard", or the quote can no longer be accepted.
- 500server_errorSomething failed on the server; try again.
request_action
Act on a request
- Needs sign-in
- Cannot be undone
- Not safe to repeat
- Reaches email or suppliers
The order page's other actions; confirm each with the person first. confirm_labs (status new): send the request to suppliers by supplier_ids (from suggestions) or slugs. set_acceptance: what the order must meet. answer_question: answer a supplier's question (rfq_id, answer). add_shipment: record what is being sent (material, samples). pay: returns payment_url, a Stripe Checkout link for the person to open; you cannot pay. decide_change: approve or decline a change (change_id, approve). accept_results or request_rerun (reason) once delivered. request_release: storage, give notice to leave. To accept a quote use accept_quote.
Arguments
- request_id string, requiredThe request id (req_...).
- action "confirm_labs" | "set_acceptance" | "answer_question" | "add_shipment" | "pay" | "decide_change" | "accept_results" | "request_rerun" | "request_release", required
- supplier_ids array of stringconfirm_labs: ids from the request's suggestions.
- slugs array of stringconfirm_labs: supplier slugs.
- acceptance objectset_acceptance: term to value.
- rfq_id stringanswer_question: the question's rfq id.
- answer stringanswer_question: the answer.
- material objectadd_shipment: what is being sent.
- samples array of object
- booked_by "client" | "lab"add_shipment: who books the courier.
- payment_id stringpay: the payment id (pay_...) from get_request.
- change_id stringdecide_change: the change id (co_...).
- approve booleandecide_change: true to approve.
- reason stringrequest_rerun: what is wrong.
- kind stringrequest_rerun: the kind of problem.
- quantity stringrequest_rerun: how much is affected.
- photos array of stringrequest_rerun: links to files uploaded to this order.
{
"request_id": "req_Xq3v9KpL2aB7",
"action": "confirm_labs",
"supplier_ids": [
"sup_Tb6yE2mC9kW1"
]
}Returns the same object as POST /api/v1/requests/{id}/actions, as JSON text.
readOnlyHint false, destructiveHint true, idempotentHint false, openWorldHint true
Errors
- 401sign_in_requiredNot signed in: call sign_in and verify_code, or connect with an API key.
- 404not_foundNo request with that id for this account.
- 400invalid_requestThe action does not fit the request's status, or a field is missing.
- 500server_errorSomething failed on the server; try again.
cancel_request
Cancel a request
- Needs sign-in
- Cannot be undone
- Safe to repeat
- Stays on the server
Cancels a request before it is paid; open quotes are withdrawn. It cannot be undone, so confirm with the person first.
Arguments
- request_id string, requiredThe request id (req_...).
- reason string
{
"request_id": "req_Xq3v9KpL2aB7",
"reason": "Ordered elsewhere"
}Returns the same object as POST /api/v1/requests/{id}/cancel, as JSON text.
readOnlyHint false, destructiveHint true, idempotentHint true, openWorldHint false
Errors
- 401sign_in_requiredNot signed in: call sign_in and verify_code, or connect with an API key.
- 404not_foundNo request with that id for this account.
- 409not_cancellableAlready paid or under way.
- 500server_errorSomething failed on the server; try again.