Quickstart

Connect Moonlit Legal Research to Claude or any MCP-compatible client.

Base URL

https://mcp.moonlit.ai/

Authentication

Moonlit MCP uses OAuth 2.1 with Dynamic Client Registration and PKCE S256. The consent screen accepts your API key as the identity factor. The OAuth handshake completes automatically. You do not register an OAuth client yourself.

StepWhat happens
1. Client registersDynamic Client Registration (RFC 7591)
2. User authorizesConsent page accepts the API key
3. Token exchangePKCE S256, Bearer token issued

If you do not have an API key, get your key here. 7 day trial.

Connect in Claude.ai

  1. Open Claude.ai. Click Customize in the left sidebar, then Connectors.
  2. Click the + button, then Add custom connector.
  3. Set the name to Moonlit Legal Research.
  4. Paste the remote server URL: https://mcp.moonlit.ai/.
  5. Click Add. A browser tab opens at the Moonlit consent page.
  6. Paste your API key into the input box. Click Login.
  7. The browser redirects back. Tools are available in your next chat.
Coming very soon to the Claude directory, so you can add Moonlit Legal Research without pasting a server URL.

Tip: when configuring the connector, allow all tools. Claude can then decide which tool to use when, which is the most useful behaviour for legal research.

Connect in Claude Code

  1. Run claude mcp add --transport http moonlit https://mcp.moonlit.ai/.
  2. Trigger the OAuth flow with /mcp. Claude Code opens the consent page in your browser.
  3. Paste your API key. Click Login.
  4. Verify with claude mcp list.

First call

Prompt:

Find the official text of Article 6 of the EU AI Act.

Expected response shape: a citation to CELEX 32024R1689 with the source URL to the original document at the publisher, followed by the article text.

Under the hood, Claude calls convert_to_celex("EU AI Act"), then get_document_articles("32024R1689") or retrieve_document, and returns the citation.

Troubleshooting first connect

  • OAuth never completes. Allow pop-ups for claude.ai and mcp.moonlit.ai. Disable third-party cookie blocking for mcp.moonlit.ai.
  • API key rejected at consent. Key is expired, rotated, or wrong tenant. Email support@moonlit.ai.
  • get_filters returns nothing. Outbound HTTPS to mcp.moonlit.ai is blocked. Allow it at your firewall.

Next: Use cases.