Midgard Industrial

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 Code
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
Check the connection and list the tools
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.

Example arguments
{}

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
Example arguments
{
  "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.
Example arguments
{
  "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.
Example arguments
{
  "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.
Example arguments
{
  "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.
Example arguments
{
  "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.

Example arguments
{}

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.
Example arguments
{
  "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.
Example arguments
{
  "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_...).
Example arguments
{
  "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_...).
Example arguments
{
  "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
Example arguments
{
  "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.
Example arguments
{
  "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.
Example arguments
{
  "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
Example arguments
{
  "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.
MCP server and tools · Midgard Industrial