vpn_keyMCP Connection & API Key

Everything needed to connect an MCP client to Lawmadi OS and issue a key for tool calls. This guide is readable without signing in; key issuance takes one email verification below.

info Server registration and health checks need no key. initialize, tools/list and ping (discovery) answer unauthenticated. A key is required only for tools/call.

1. Connection details

Enter these values as-is in your MCP client or registration console.

MCP endpoint	`https://lawmadi.com/mcp`
Transport	Streamable HTTP — JSON-RPC 2.0 over `POST` (one JSON response per request)
Identifier	`lawmadios` · server name `Lawmadi OS`
Protocol versions	`2024-11-05` · `2025-03-26` · `2025-06-18` · `2025-11-25` (the requested version is echoed back)
Authentication	Key/Token — HTTP header `Authorization: Bearer <API key>`
GET /mcp	No server-initiated SSE channel, so it returns `405 Method Not Allowed` — expected per the MCP spec. Use `POST` for all calls.

lock_openNo key

initializetools/listpingget_pricing

Registration, status checks, pricing and the key-issuance path all answer unauthenticated — a registry health check lands here.

keyKey needed

askask_expertlookup_statutelookup_precedentverify_citationsgenerate_document…

Every other tools/call. No key sent → -32001; wrong or revoked key → -32002, both carrying the issuance path in the response.

2. Where do I get the API key?

Right here — no application or approval step. Only a hash of the key is stored, so the full key is shown once, immediately after creation.

01mail

Sign in with email

Enter the 6-digit code sent to your inbox. No application form, no approval step.

No signup form3 free credits · one time

02vpn_key

Issue the key — on this page

Press Issue API key below and it is created instantly. Only a hash is stored, so the full key is shown once.

lmk_live_…Up to 10 active keysRevocation is immediate

03send

Send it as a Bearer header

Add it to your MCP client and tools/call opens up.

Authorization: Bearer lmk_live_…

04savings

Top up when needed

After the free credits, buy more on the pricing page. Purchased credits never expire.

Lookup tools cost no credits

progress_activity Checking your session…

3. Client configuration

Passing the key in the Authorization header works the same way in every MCP client.

MCP client config (JSON)

{
  "mcpServers": {
    "lawmadi": {
      "type": "http",
      "url": "https://lawmadi.com/mcp",
      "headers": {
        "Authorization": "Bearer lmk_live_YOUR_KEY_HERE"
      }
    }
  }
}

Verify the connection without a key

curl -s https://lawmadi.com/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize",
       "params":{"protocolVersion":"2025-06-18","capabilities":{},
                 "clientInfo":{"name":"health-check","version":"1"}}}'

Call a tool with the key

curl -s https://lawmadi.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer lmk_live_YOUR_KEY_HERE' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"lookup_statute","arguments":{"reference":"민법 제750조"}}}'

lightbulb Agents can discover this path through tools too: get_pricing needs no key and returns the sign-up → key → top-up sequence, and get_account reports the balance for a key.

4. Key management rules

lockOnly a hash is stored — a lost key cannot be shown again; revoke it and issue a new one.
inventory_2Up to 10 active keys per account; revoke one to make room.
blockRevocation is immediate — tools/call with that key is refused right away.
savingsLookup tools (lookup_precedent, lookup_statute, verify_citations, bar_exam_search, find_village_lawyer, latest_content) call no LLM and consume no credits (daily per-key cap, resets 00:00 KST).
support_agentAn -32002 error means the key is invalid or revoked — check for typos, then reissue here.

5. MCP key vs. expert REST API key

There are two kinds of key. For MCP, use the one issued on this page.

MCP key (this page)	Email sign-in is enough · for `https://lawmadi.com/mcp` tool calls · metered by credits
Expert REST API key	For B2B `/api/v1/expert/ask` only · issued in the expert API console on the Pro plan · see Expert API

workspace_premiumPricing language한국어

mail If issuance does not work, or you need a key for a platform review, contact admin@lawmadi.com.