Lightsage MCP - Lightsage
Documentation Index
Fetch the complete documentation index at: /docs/llms.txt
Use this file to discover all available pages before exploring further.
Lightsage MCP gives AI agents direct access to the Lightsage public API through the Model Context Protocol. Use it when you want an agent to list prompts, inspect API Performance configuration, create eval runs, retrieve results, or manage Lightsage resources without shelling out to the Lightsage CLI.
Install by client
Choose the client you want to configure. Each guide connects the client to https://mcp.lightsage.com/mcp.Lightsage MCP supports two authentication methods:
- OAuth — hosted connector surfaces (ChatGPT, Claude web/Desktop) sign in with your Lightsage account and pick an organization. No API key required.
X-Lightsage-Api-Keyheader — coding agents and CLI-based clients send a Lightsage API key from the dashboard.
\ \ ChatGPT \ \ Add Lightsage in developer mode with its public OAuth client.](/content/docs/mcp-reference/chatgpt/index.html)
\ \ Claude \ \ Add Lightsage as a custom connector in Claude web or Desktop with OAuth.](/content/docs/mcp-reference/claude/index.html)
\ \ Claude Code \ \ Add Lightsage as a remote HTTP MCP server with a custom auth header.](/content/docs/mcp-reference/claude-code/index.html)
\
\
Codex \
\
Configure Lightsage MCP in ~/.codex/config.toml.](/content/docs/mcp-reference/codex/index.html)
\ \ Cursor \ \ Add Lightsage MCP to your global or project Cursor MCP config.](/content/docs/mcp-reference/cursor/index.html)
\ \ Gemini CLI \ \ Add Lightsage MCP to Gemini CLI with a streamable HTTP server.](/content/docs/mcp-reference/gemini-cli/index.html)
\ \ GitHub Copilot \ \ Configure Lightsage MCP for GitHub Copilot in VS Code or Copilot CLI.](/content/docs/mcp-reference/github-copilot/index.html)
\ \ Kilo \ \ Configure Lightsage MCP as a remote server in Kilo.](/content/docs/mcp-reference/kilo/index.html)
\
\
OpenCode \
\
Configure Lightsage as a remote MCP server in opencode.json.](/content/docs/mcp-reference/opencode/index.html)
Run the local package
For clients that require a local stdio process, run the published MCP package:
export LIGHTSAGE_API_KEY="ls_cli_your_api_key"
npx -y @lightsage/mcp start --lightsage-api-key-auth "$LIGHTSAGE_API_KEY"
Verify the connection
After configuring a client, start with a read-only prompt:
Use the Lightsage MCP server to check my Lightsage auth status.
Then try a low-risk API Performance prompt:
Use Lightsage MCP to list my API Performance targets and summarize the available coding agents.
For GEO outreach research, ask for URL-level citation data:
Use Lightsage MCP to list the 20 most cited URLs on ChatGPT over the last 30 days, including each citation count.
If the client cannot list tools, confirm the endpoint is reachable:
curl -i https://mcp.lightsage.com/mcp
OAuth-enabled clients receive a 401 Unauthorized challenge before sign-in. The response must include:
WWW-Authenticate: Bearer resource_metadata="https://mcp.lightsage.com/.well-known/oauth-protected-resource/mcp"
Troubleshooting
| Problem | Fix |
|---|---|
The client connects but tool calls return 401 |
For header auth, confirm the client is sending X-Lightsage-Api-Key with a valid Lightsage API key. For OAuth, re-run the sign-in flow so the client gets a fresh token. |
| A ChatGPT custom connector fails during OAuth | Follow the ChatGPT manual OAuth setup. Do not use automatic client registration. |
| The client has no custom header field | Use OAuth instead (ChatGPT, Claude web/Desktop), or pick a client that can send custom headers. |
| The client only supports local stdio MCP | Use a local stdio-to-HTTP bridge that forwards to the hosted Lightsage MCP endpoint. |
| Too many tools appear in context | Use the hosted deployment’s default dynamic mode, which exposes discovery tools first. |
Related docs
- CLI Reference - install and authenticate the Lightsage CLI
- Build an MCP server for direct coding agent access - learn how MCP changes agent recommendations
- API Performance runs - inspect runs from the CLI
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Lightsage","colors":{"primary":"#0EA5E9","light":"#38BDF8","dark":"#0284C7"},"logo":{"light":"https://mintcdn.com/sapient-14d4e375/0RQiSxJPQv6MyuZt/images/lightsage-logo-with-text-light.svg?fit=max\\u0026auto=format\\u0026n=0RQiSxJPQv6MyuZt\\u0026q=85\\u0026s=843d0563baa54c778891f942711ab938","dark":"https://mintcdn.com/sapient-14d4e375/0RQiSxJPQv6MyuZt/images/lightsage-logo-with-text-dark.svg?fit=max\\u0026auto=format\\u0026n=0RQiSxJPQv6MyuZt\\u0026q=85\\u0026s=0ec933f6e5153f8392cb4c5f19b7017f"},"favicon":"https://mintcdn.com/sapient-14d4e375/lnqlKs8p\_hzadcGt/images/favicon.png?fit=max\\u0026auto=format\\u0026n=lnqlKs8p\_hzadcGt\\u0026q=85\\u0026s=358b3be56f25189cd6d5417fd300fefc","background":{"color":{"light":"#FFFFFF","dark":"#0D0C0C"}},"navbar":{"links":\[{"href":"https://lightsage.com","label":"Homepage"}\],"primary":{"type":"button","label":"Dashboard","href":"https://app.lightsage.com"}},"seo":{"indexing":"all"},"fonts":{"family":"Geist"},"integrations":{"ga4":{"measurementId":"G-417S0EJVMS"},"posthog":{"apiKey":"phc\_yrA1TjjqeYfsoJEofjxd0Bw7cTrxs8N402k3NwusII7"}},"contextual":{"options":\["copy","chatgpt","cursor","vscode"\],"display":"header"},"styling":{"latex":false},"navigation":{"pages":\[\]}},"deployment":{"deploymentMetadataValue":{"subdomain":"sapient-14d4e375","hasAudioNarration":false,"actualSubdomain":"sapient-14d4e375","customDomains":\["lightsage.com"\],"gitSource":{"type":"github","owner":"lightsagehq","repo":"docs","deployBranch":"main","isPrivate":true,"contentDirectory":"","mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae02893fa64afb3742fc617","collectionId":"5733d0e5-4574-4b13-bbeb-88d7bc3f6d01","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae02893fa64afb3742fc617"},"entitlements":{"AI\_CHAT":{"status":"DISABLED"}},"buildId":"6ae02c324c09e96410641fcb","clientVersion":"0.0.3971","searchFilterCounts":\[{"language":"default","tag":"API Reference","count":74},{"language":"default","tag":"CLI Reference","count":18},{"language":"default","tag":"Evals","count":14},{"language":"default","tag":"Documentation","count":13},{"language":"default","tag":"Prompts","count":13},{"language":"default","tag":"Visibility","count":12},{"language":"default","tag":"MCP Reference","count":10},{"language":"default","tag":"Clients","count":9},{"language":"default","tag":"Agent Preference","count":8},{"language":"default","tag":"Agent Analytics","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"mcp-reference","slug":"/mcp-reference","pageMetadata":{"title":"Lightsage MCP","sidebarTitle":"Overview","description":"Choose a client and connect Lightsage MCP to coding agents and MCP-capable tools.","icon":"plug","href":"/mcp-reference/index"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Choose a client and connect Lightsage MCP to coding agents and MCP-capable tools.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Card,CardGroup,CodeBlock,Heading,Table}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Lightsage MCP gives AI agents direct access to the Lightsage public API through the Model Context Protocol. Use it when you want an agent to list prompts, inspect API Performance configuration, create eval runs, retrieve results, or manage Lightsage resources without shelling out to the Lightsage CLI.`}),`\n`,_jsx(Heading,{level:`2`,id:`install-by-client`,children:`Install by client`}),`\n`,_jsxs(_components.p,{children:[`Choose the client you want to configure. Each guide connects the client to `,_jsx(_components.code,{children:`https://mcp.lightsage.com/mcp\`}),\`.\`\]}),\`\\n\`,\_jsx(_components.p,{children:`Lightsage MCP supports two authentication methods:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`OAuth`}),` — hosted connector surfaces (ChatGPT, Claude web/Desktop) sign in with your Lightsage account and pick an organization. No API key required.`]}),`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`X-Lightsage-Api-Key`}),` header`]}),` — coding agents and CLI-based clients send a Lightsage API key from the `,_jsx(_components.a,{href:`https://app.lightsage.com/settings/api\`,children:\`dashboard\`}),\`.\`\]}),\`\\n\`\]}),\`\\n\`,\_jsxs(CardGroup,{cols:3,children:[_jsx(Card,{title:`ChatGPT`,icon:`https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/openai.svg?fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=e6b743c87b5319e412e8acfbeb49a070\`,href:\`/mcp-reference/chatgpt\`,\\"data-og-width\\":\`24\`,width:\`24\`,\\"data-og-height\\":\`24\`,height:\`24\`,\\"data-path\\":\`images/mcp-icons/openai.svg\`,\\"data-optimize\\":\`true\`,\\"data-opv\\":\`3\`,srcset:\`https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/openai.svg?w=280\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=84d7e498f14fc5387441930b5fa7c70d 280w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/openai.svg?w=560\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=ca91a5e03faaca38d1ee4a7d42e76961 560w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/openai.svg?w=840\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=b28105b5641d6d536865474f1e8d43ac 840w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/openai.svg?w=1100\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=368af3cf89570356a0bc37f493d8578e 1100w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/openai.svg?w=1650\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=62f12d0f57a2d7f7f2a2a7cfea2317cc 1650w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/openai.svg?w=2500\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=fbf495c85d278d6e3117c367d25d07f6 2500w`,children:_jsx(_components.p,{children:`Add Lightsage in developer mode with its public OAuth client.`})}),_jsx(Card,{title:`Claude`,icon:`https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/claude.svg?fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=e6c93e69b2742291b8d22af777f46212\`,href:\`/mcp-reference/claude\`,\\"data-og-width\\":\`24\`,width:\`24\`,\\"data-og-height\\":\`24\`,height:\`24\`,\\"data-path\\":\`images/mcp-icons/claude.svg\`,\\"data-optimize\\":\`true\`,\\"data-opv\\":\`3\`,srcset:\`https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/claude.svg?w=280\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=74abf43d8b1f9b3e8ddabb7c948f91e5 280w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/claude.svg?w=560\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=8b3cecfaf91c7b269379f2ea8b8d6916 560w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/claude.svg?w=840\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=ea64f7119941a4ac1e7d5bd5c26db581 840w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/claude.svg?w=1100\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=2eac319471ad6fc15d425053efc35f27 1100w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/claude.svg?w=1650\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=aac1cbbad111ed104e6c1dc23458d49c 1650w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/claude.svg?w=2500\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=d1c6b862ae44733e164a15c58fcee6fd 2500w`,children:_jsx(_components.p,{children:`Add Lightsage as a custom connector in Claude web or Desktop with OAuth.`})}),_jsx(Card,{title:`Claude Code`,icon:`https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/claude.svg?fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=e6c93e69b2742291b8d22af777f46212\`,href:\`/mcp-reference/claude-code\`,\\"data-og-width\\":\`24\`,width:\`24\`,\\"data-og-height\\":\`24\`,height:\`24\`,\\"data-path\\":\`images/mcp-icons/claude.svg\`,\\"data-optimize\\":\`true\`,\\"data-opv\\":\`3\`,srcset:\`https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/claude.svg?w=280\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=74abf43d8b1f9b3e8ddabb7c948f91e5 280w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/claude.svg?w=560\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=8b3cecfaf91c7b269379f2ea8b8d6916 560w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/claude.svg?w=840\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=ea64f7119941a4ac1e7d5bd5c26db581 840w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/claude.svg?w=1100\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=2eac319471ad6fc15d425053efc35f27 1100w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/claude.svg?w=1650\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=aac1cbbad111ed104e6c1dc23458d49c 1650w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/claude.svg?w=2500\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=d1c6b862ae44733e164a15c58fcee6fd 2500w`,children:_jsx(_components.p,{children:`Add Lightsage as a remote HTTP MCP server with a custom auth header.`})}),_jsx(Card,{title:`Codex`,icon:`https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/codex.svg?fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=2301c82c71c58f388327b69352eab760\`,href:\`/mcp-reference/codex\`,\\"data-og-width\\":\`24\`,width:\`24\`,\\"data-og-height\\":\`24\`,height:\`24\`,\\"data-path\\":\`images/mcp-icons/codex.svg\`,\\"data-optimize\\":\`true\`,\\"data-opv\\":\`3\`,srcset:\`https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/codex.svg?w=280\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=5cbfd3dd295f196ee952e8ef41dc6f49 280w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/codex.svg?w=560\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=52ae11066799b690ac8d1c5c18ffd24a 560w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/codex.svg?w=840\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=694d3987d1ce8da2cef85991685d7081 840w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/codex.svg?w=1100\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=9f047e88b398be6e1ce92e226c5f7822 1100w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/codex.svg?w=1650\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=d75ef2acef5c6338153e34ab93c648e0 1650w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/codex.svg?w=2500\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=b80755994cfd54a8ebf3381375864e38 2500w`,children:_jsxs(_components.p,{children:[`Configure Lightsage MCP in `,_jsx(_components.code,{children:`~/.codex/config.toml`}),`.`]})}),_jsx(Card,{title:`Cursor`,icon:`https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/cursor.svg?fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=95c4200ad125ebb58138446aa3d48a65\`,href:\`/mcp-reference/cursor\`,\\"data-og-width\\":\`24\`,width:\`24\`,\\"data-og-height\\":\`24\`,height:\`24\`,\\"data-path\\":\`images/mcp-icons/cursor.svg\`,\\"data-optimize\\":\`true\`,\\"data-opv\\":\`3\`,srcset:\`https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/cursor.svg?w=280\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=205644c1e5091bf558170f19d3b537cc 280w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/cursor.svg?w=560\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=c532a2d4b643b1ae7e3b36503b996495 560w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/cursor.svg?w=840\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=8342c6c1ecc9409fc6e8aa1d1e75c5d0 840w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/cursor.svg?w=1100\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=20579de8912d0858ec5ae3c06fe9f265 1100w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/cursor.svg?w=1650\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=db2c163190050437b2b7d7e83d1a9e47 1650w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/cursor.svg?w=2500\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=3fdc0b872e06bfb5461405976215f0ce 2500w`,children:_jsx(_components.p,{children:`Add Lightsage MCP to your global or project Cursor MCP config.`})}),_jsx(Card,{title:`Gemini CLI`,icon:`https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/gemini.svg?fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=e4c7fad7d2db4e31be9ebc394c5034ec\`,href:\`/mcp-reference/gemini-cli\`,\\"data-og-width\\":\`65\`,width:\`65\`,\\"data-og-height\\":\`65\`,height:\`65\`,\\"data-path\\":\`images/mcp-icons/gemini.svg\`,\\"data-optimize\\":\`true\`,\\"data-opv\\":\`3\`,srcset:\`https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/gemini.svg?w=280\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=9c1c08458e701ea6706dfdc9751ab156 280w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/gemini.svg?w=560\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=17e736fda6155eda32ef3a82fb644952 560w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/gemini.svg?w=840\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=2a65f6c3e3dcc4a51414812a27f1049d 840w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/gemini.svg?w=1100\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=d6f3dd38c1bb686665214965a0c468d3 1100w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/gemini.svg?w=1650\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=0d64ff0969e745932d5edbae3484d6db 1650w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/gemini.svg?w=2500\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=d3cf49ba9ad59435e408a13ff9fa209b 2500w`,children:_jsx(_components.p,{children:`Add Lightsage MCP to Gemini CLI with a streamable HTTP server.`})}),_jsx(Card,{title:`GitHub Copilot`,icon:`https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/github-copilot.svg?fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=e9605a8dab5a3d0132a410d565e5669c\`,href:\`/mcp-reference/github-copilot\`,\\"data-og-width\\":\`24\`,width:\`24\`,\\"data-og-height\\":\`24\`,height:\`24\`,\\"data-path\\":\`images/mcp-icons/github-copilot.svg\`,\\"data-optimize\\":\`true\`,\\"data-opv\\":\`3\`,srcset:\`https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/github-copilot.svg?w=280\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=a5dbf3d1fa84d71c5e62ba509c321b57 280w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/github-copilot.svg?w=560\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=da07d00e08f6f61ca025a951a8a23c8e 560w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/github-copilot.svg?w=840\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=c369c4a33fcd0dbe6c1991855a43cfc0 840w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/github-copilot.svg?w=1100\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=aefbd9658d4c7d9b8e0df5945a755af9 1100w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/github-copilot.svg?w=1650\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=9f1749b75256001e824254cb95048c3d 1650w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/github-copilot.svg?w=2500\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=797bb2966b23b1bdd430ec04434cfe58 2500w`,children:_jsx(_components.p,{children:`Configure Lightsage MCP for GitHub Copilot in VS Code or Copilot CLI.`})}),_jsx(Card,{title:`Kilo`,icon:`https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/kilo.svg?fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=3096cf79a5c08fe07f6698116620fc1c\`,href:\`/mcp-reference/kilo\`,\\"data-og-width\\":\`32\`,width:\`32\`,\\"data-og-height\\":\`32\`,height:\`32\`,\\"data-path\\":\`images/mcp-icons/kilo.svg\`,\\"data-optimize\\":\`true\`,\\"data-opv\\":\`3\`,srcset:\`https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/kilo.svg?w=280\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=1d8edecbf5975771019d0dc2f44f8016 280w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/kilo.svg?w=560\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=f7e4bd99bac2d0ab3250f1120b3d14e0 560w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/kilo.svg?w=840\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=5e03fc684692ba84dd074658a0efcc6d 840w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/kilo.svg?w=1100\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=2bfd83bb136596142dec07da81b4a9a9 1100w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/kilo.svg?w=1650\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=ab32967cf1884f6bb6cb06c250b55d72 1650w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/kilo.svg?w=2500\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=b110d3f9e7a85b9dda6f3a2e89163a58 2500w`,children:_jsx(_components.p,{children:`Configure Lightsage MCP as a remote server in Kilo.`})}),_jsx(Card,{title:`OpenCode`,icon:`https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/opencode.svg?fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=115b57370743754113604f7034c13a0b\`,href:\`/mcp-reference/opencode\`,\\"data-og-width\\":\`240\`,width:\`240\`,\\"data-og-height\\":\`300\`,height:\`300\`,\\"data-path\\":\`images/mcp-icons/opencode.svg\`,\\"data-optimize\\":\`true\`,\\"data-opv\\":\`3\`,srcset:\`https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/opencode.svg?w=280\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=ba9223ce69c8234f778729721002d2e0 280w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/opencode.svg?w=560\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=58ed13333f0b2d795a7c1b1031cced00 560w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/opencode.svg?w=840\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=7fc505ccba38c8420971a75541d0ddc5 840w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/opencode.svg?w=1100\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=f207cebc2497f7c990bf3546f392e1ce 1100w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/opencode.svg?w=1650\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=5309fb2fd1fa3236cee1a83fa08ddf08 1650w, https://mintcdn.com/sapient-14d4e375/qxhkraBSjyCB4qIr/images/mcp-icons/opencode.svg?w=2500\\u0026fit=max\\u0026auto=format\\u0026n=qxhkraBSjyCB4qIr\\u0026q=85\\u0026s=bf122d77d0c23842179fbc54d86be7b1 2500w`,children:_jsxs(_components.p,{children:[`Configure Lightsage as a remote MCP server in `,_jsx(_components.code,{children:`opencode.json`}),`.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`run-the-local-package`,children:`Run the local package`}),`\n`,_jsx(_components.p,{children:`For clients that require a local stdio process, run the published MCP package:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`export`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` LIGHTSAGE_API_KEY`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ls_cli_your_api_key\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`npx`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -y`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` @lightsage/mcp`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` start`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --lightsage-api-key-auth`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$LIGHTSAGE_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`verify-the-connection`,children:`Verify the connection`}),`\n`,_jsx(_components.p,{children:`After configuring a client, start with a read-only prompt:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Use the Lightsage MCP server to check my Lightsage auth status.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.p,{children:`Then try a low-risk API Performance prompt:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Use Lightsage MCP to list my API Performance targets and summarize the available coding agents.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.p,{children:`For GEO outreach research, ask for URL-level citation data:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Use Lightsage MCP to list the 20 most cited URLs on ChatGPT over the last 30 days, including each citation count.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.p,{children:`If the client cannot list tools, confirm the endpoint is reachable:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -i`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://mcp.lightsage.com/mcp\`})\]}),\`\\n\`\]})})}),\`\\n\`,\_jsxs(_components.p,{children:[`OAuth-enabled clients receive a `,_jsx(_components.code,{children:`401 Unauthorized`}),` challenge before sign-in. The response must include:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`WWW-Authenticate: Bearer resource_metadata=\"https://mcp.lightsage.com/.well-known/oauth-protected-resource/mcp\\"\`})}),\`\\n\`,\_jsx(\_components.span,{className:\`line\`,children:\_jsx(\_components.span,{})})\]})})}),\`\\n\`,\_jsx(Heading,{level:\`2\`,id:\`troubleshooting\`,children:\`Troubleshooting\`}),\`\\n\`,\_jsxs(Table,{children:\[\_jsx(\_components.thead,{children:\_jsxs(\_components.tr,{children:\[\_jsx(\_components.th,{children:\`Problem\`}),\_jsx(\_components.th,{children:\`Fix\`})\]})}),\_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`The client connects but tool calls return `,_jsx(_components.code,{children:`401`})]}),_jsxs(_components.td,{children:[`For header auth, confirm the client is sending `,_jsx(_components.code,{children:`X-Lightsage-Api-Key`}),` with a valid Lightsage API key. For OAuth, re-run the sign-in flow so the client gets a fresh token.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`A ChatGPT custom connector fails during OAuth`}),_jsxs(_components.td,{children:[`Follow the `,_jsx(_components.a,{href:`/mcp-reference/chatgpt`,children:`ChatGPT manual OAuth setup`}),`. Do not use automatic client registration.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`The client has no custom header field`}),_jsx(_components.td,{children:`Use OAuth instead (ChatGPT, Claude web/Desktop), or pick a client that can send custom headers.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`The client only supports local stdio MCP`}),_jsx(_components.td,{children:`Use a local stdio-to-HTTP bridge that forwards to the hosted Lightsage MCP endpoint.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Too many tools appear in context`}),_jsx(_components.td,{children:`Use the hosted deployment’s default dynamic mode, which exposes discovery tools first.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`related-docs`,children:`Related docs`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/cli-reference`,children:`CLI Reference`}),` - install and authenticate the Lightsage CLI`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/guides/mcp-servers`,children:`Build an MCP server for direct coding agent access`}),` - learn how MCP changes agent recommendations`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/cli-reference/api-performance-runs`,children:`API Performance runs`}),` - inspect runs from the CLI`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Lightsage MCP","sidebarTitle":"Overview","description":"Choose a client and connect Lightsage MCP to coding agents and MCP-capable tools.","icon":"plug","href":"/mcp-reference/index"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Install by client","slug":"install-by-client","depth":2,"children":[]},{"title":"Run the local package","slug":"run-the-local-package","depth":2,"children":[]},{"title":"Verify the connection","slug":"verify-the-connection","depth":2,"children":[]},{"title":"Troubleshooting","slug":"troubleshooting","depth":2,"children":[]},{"title":"Related docs","slug":"related-docs","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"sapient-14d4e375","siteName":"Lightsage","title":"Lightsage MCP - Lightsage","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-03T22:01:20.787Z","originalFileLocation":"mcp-reference/index.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Choose a client and connect Lightsage MCP to coding agents and MCP-capable tools.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Lightsage\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/sapient-14d4e375/dqjrUzdCO-t6TId6/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/sapient-14d4e375/dqjrUzdCO-t6TId6/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/sapient-14d4e375/dqjrUzdCO-t6TId6/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/sapient-14d4e375/dqjrUzdCO-t6TId6/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/sapient-14d4e375/dqjrUzdCO-t6TId6/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/sapient-14d4e375/dqjrUzdCO-t6TId6/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/sapient-14d4e375/dqjrUzdCO-t6TId6/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/sapient-14d4e375/dqjrUzdCO-t6TId6/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/sapient-14d4e375/dqjrUzdCO-t6TId6/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Lightsage MCP - Lightsage\">\u003cmeta data-mint-head property=\"og:description\" content=\"Choose a client and connect Lightsage MCP to coding agents and MCP-capable tools.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Lightsage\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://lightsage.com/docs/mcp-reference\\">\\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://sapient-14d4e375.mintlify.app/\_mintlify/api/og/v2?division=Getting+Started\\u0026amp;title=Lightsage+MCP\\u0026amp;description=Choose+a+client+and+connect+Lightsage+MCP+to+coding+agents+and+MCP-capable+tools.\\u0026amp;theme=dd8ce0054346ff07fc865000\\u0026amp;signature=27021cc90e949e9365d6b3949ae792b689c1254628a2c9ddc9208b4b9faf75a8\\">\\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Lightsage MCP - Lightsage\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Choose a client and connect Lightsage MCP to coding agents and MCP-capable tools.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://sapient-14d4e375.mintlify.app/\_mintlify/api/og/v2?division=Getting+Started\\u0026amp;title=Lightsage+MCP\\u0026amp;description=Choose+a+client+and+connect+Lightsage+MCP+to+coding+agents+and+MCP-capable+tools.\\u0026amp;theme=dd8ce0054346ff07fc865000\\u0026amp;signature=27021cc90e949e9365d6b3949ae792b689c1254628a2c9ddc9208b4b9faf75a8\\">\\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/sapient-14d4e375/dqjrUzdCO-t6TId6/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Lightsage\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0EA5E9\">\u003clink data-mint-head rel=\"canonical\" href=\"https://lightsage.com/docs/mcp-reference\\">\\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/mcp-reference.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\\",\\"@graph\\":\[{\\"@type\\":\\"Organization\\",\\"@id\\":\\"https://lightsage.com/#organization\\",\\"name\\":\\"Lightsage\\",\\"url\\":\\"https://lightsage.com\\",\\"logo\\":{\\"@type\\":\\"ImageObject\\",\\"url\\":\\"https://mintcdn.com/sapient-14d4e375/0RQiSxJPQv6MyuZt/images/lightsage-logo-with-text-light.svg?fit=max\\u0026auto=format\\u0026n=0RQiSxJPQv6MyuZt\\u0026q=85\\u0026s=843d0563baa54c778891f942711ab938\\"}},{\\"@type\\":\\"WebSite\\",\\"@id\\":\\"https://lightsage.com/docs#website\\",\\"name\\":\\"Lightsage\\",\\"url\\":\\"https://lightsage.com/docs\\",\\"publisher\\":{\\"@id\\":\\"https://lightsage.com/#organization\\"}},{\\"@type\\":\\"WebPage\\",\\"@id\\":\\"https://lightsage.com/docs/mcp-reference#webpage\\",\\"url\\":\\"https://lightsage.com/docs/mcp-reference\\",\\"name\\":\\"Lightsage MCP\",\"description\":\"Choose a client and connect Lightsage MCP to coding agents and MCP-capable tools.\",\"dateModified\":\"2026-09-03T22:01:20.787Z\",\"isPartOf\":{\"@id\":\"https://lightsage.com/docs#website\\"},\\"breadcrumb\\":{\\"@id\\":\\"https://lightsage.com/docs/mcp-reference#breadcrumb\\"}},{\\"@type\\":\\"BreadcrumbList\\",\\"@id\\":\\"https://lightsage.com/docs/mcp-reference#breadcrumb\\",\\"itemListElement\\":\[{\\"@type\\":\\"ListItem\\",\\"position\\":1,\\"name\\":\\"Getting Started\",\"item\":\"https://lightsage.com/docs/mcp-reference/index\\"},{\\"@type\\":\\"ListItem\\",\\"position\\":2,\\"name\\":\\"Lightsage MCP\",\"item\":\"https://lightsage.com/docs/mcp-reference\\"}\]},{\\"@type\\":\[\\"Article\\",\\"TechArticle\\"\],\\"@id\\":\\"https://lightsage.com/docs/mcp-reference#article\\",\\"headline\\":\\"Lightsage MCP\",\"name\":\"Lightsage MCP\",\"description\":\"Choose a client and connect Lightsage MCP to coding agents and MCP-capable tools.\",\"url\":\"https://lightsage.com/docs/mcp-reference\\",\\"mainEntityOfPage\\":{\\"@id\\":\\"https://lightsage.com/docs/mcp-reference#webpage\\"},\\"dateModified\\":\\"2026-09-03T22:01:20.787Z\\",\\"publisher\\":{\\"@id\\":\\"https://lightsage.com/#organization\\"},\\"isPartOf\\":{\\"@id\\":\\"https://lightsage.com/docs#website\\"}}\]}\\u003c/script>\\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\\",\\"@type\\":\\"WebSite\\",\\"name\\":\\"Lightsage\\",\\"creator\\":{\\"@type\\":\\"Organization\\",\\"name\\":\\"Mintlify\\",\\"url\\":\\"https://mintlify.com\\"}}\\u003c/script>","siteName":"Lightsage","nav":{"global":null,"tabs":\[{"tab":"Documentation","pages":\[{"title":"Documentation","href":""}\]},{"tab":"CLI Reference","pages":[{"title":"CLI Reference","href":"/cli-reference"}]},{"tab":"MCP Reference","pages":[{"group":"Getting Started","pages":[{"title":"Lightsage MCP","sidebarTitle":"Overview","icon":"plug","href":"/mcp-reference"}]},{"group":"Clients","pages":[{"title":"Install Lightsage MCP in ChatGPT","sidebarTitle":"ChatGPT","description":"Connect ChatGPT developer mode to Lightsage MCP with a preconfigured public OAuth client.","icon":"https://mintlify.s3.us-west-1.amazonaws.com/sapient-14d4e375/images/mcp-icons/openai.svg","href":"/mcp-reference/chatgpt"},{"title":"Install Lightsage MCP in Claude","sidebarTitle":"Claude","icon":"https://mintlify.s3.us-west-1.amazonaws.com/sapient-14d4e375/images/mcp-icons/claude.svg","href":"/mcp-reference/claude"},{"title":"Install Lightsage MCP in Claude Code","sidebarTitle":"Claude Code","icon":"https://mintlify.s3.us-west-1.amazonaws.com/sapient-14d4e375/images/mcp-icons/claude.svg","href":"/mcp-reference/claude-code"},{"title":"Install Lightsage MCP in Codex","sidebarTitle":"Codex","icon":"https://mintlify.s3.us-west-1.amazonaws.com/sapient-14d4e375/images/mcp-icons/codex.svg","href":"/mcp-reference/codex"},{"title":"Install Lightsage MCP in Cursor","sidebarTitle":"Cursor","icon":"https://mintlify.s3.us-west-1.amazonaws.com/sapient-14d4e375/images/mcp-icons/cursor.svg","href":"/mcp-reference/cursor"},{"title":"Install Lightsage MCP in Gemini CLI","sidebarTitle":"Gemini CLI","icon":"https://mintlify.s3.us-west-1.amazonaws.com/sapient-14d4e375/images/mcp-icons/gemini.svg","href":"/mcp-reference/gemini-cli"},{"title":"Install Lightsage MCP in GitHub Copilot","sidebarTitle":"GitHub Copilot","icon":"https://mintlify.s3.us-west-1.amazonaws.com/sapient-14d4e375/images/mcp-icons/github-copilot.svg","href":"/mcp-reference/github-copilot"},{"title":"Install Lightsage MCP in Kilo","sidebarTitle":"Kilo","icon":"https://mintlify.s3.us-west-1.amazonaws.com/sapient-14d4e375/images/mcp-icons/kilo.svg","href":"/mcp-reference/kilo"},{"title":"Install Lightsage MCP in OpenCode","sidebarTitle":"OpenCode","icon":"https://mintlify.s3.us-west-1.amazonaws.com/sapient-14d4e375/images/mcp-icons/opencode.svg","href":"/mcp-reference/opencode"}\]}\]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/introduction"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"title":"Lightsage MCP - Lightsage","buildId":"dpl_GvhK4qVXq51DpfYJLCtPpYNN4YHN","deploymentId":"dpl_GvhK4qVXq51DpfYJLCtPpYNN4YHN","dynamics":[],"chunks":[]}
![https://mintlify.com/docs.json","name":"Lightsage","colors":{"primary":"#0EA5E9","light":"#38BDF8","dark":"#0284C7"},"logo":{"light":"https://mintcdn.com/sapient-14d4e375/0RQiSxJPQv6MyuZt/images/lightsage-logo-with-text-light.svg?fit=max\\u0026auto=format\\u0026n=0RQiSxJPQv6MyuZt\\u0026q=85\\u0026s=843d0563baa54c778891f942711ab938","dark":"https://mintcdn.com/sapient-14d4e375/0RQiSxJPQv6MyuZt/images/lightsage-logo-with-text-dark.svg?fit=max\\u0026auto=format\\u0026n=0RQiSxJPQv6MyuZt\\u0026q=85\\u0026s=0ec933f6e5153f8392cb4c5f19b7017f"},"favicon":"https://mintcdn.com/sapient-14d4e375/lnqlKs8p\_hzadcGt/images/favicon.png?fit=max\\u0026auto=format\\u0026n=lnqlKs8p\_hzadcGt\\u0026q=85\\u0026s=358b3be56f25189cd6d5417fd300fefc","background":{"color":{"light":"#FFFFFF","dark":"#0D0C0C"}},"navbar":{"links":\[{"href":"https://lightsage.com","label":"Homepage"}\],"primary":{"type":"button","label":"Dashboard","href":"https://app.lightsage.com"}},"seo":{"indexing":"all"},"fonts":{"family":"Geist"},"integrations":{"ga4":{"measurementId":"G-417S0EJVMS"},"posthog":{"apiKey":"phc\_yrA1TjjqeYfsoJEofjxd0Bw7cTrxs8N402k3NwusII7"}},"contextual":{"options":\["copy","chatgpt","cursor","vscode"\],"display":"header"},"styling":{"latex":false},"navigation":{"pages":\[\]}},"deployment":{"deploymentMetadataValue":{"subdomain":"sapient-14d4e375","hasAudioNarration":false,"actualSubdomain":"sapient-14d4e375","customDomains":\["lightsage.com"\],"gitSource":{"type":"github","owner":"lightsagehq","repo":"docs","deployBranch":"main","isPrivate":true,"contentDirectory":"","mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae02893fa64afb3742fc617","collectionId":"5733d0e5-4574-4b13-bbeb-88d7bc3f6d01","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae02893fa64afb3742fc617"},"entitlements":{"AI\_CHAT":{"status":"DISABLED"}},"buildId":"6ae02c324c09e96410641fcb","clientVersion":"0.0.3971","searchFilterCounts":\[{"language":"default","tag":"API](https://mintlify.com/docs.json%22,%22name%22:%22Lightsage%22,%22colors%22:%7B%22primary%22:%22#0EA5E9%22,%22light%22:%22#38BDF8%22,%22dark%22:%22#0284C7%22%7D,%22logo%22:%7B%22light%22:%22https://mintcdn.com/sapient-14d4e375/0RQiSxJPQv6MyuZt/images/lightsage-logo-with-text-light.svg?fit=max%5C%5Cu0026auto=format%5C%5Cu0026n=0RQiSxJPQv6MyuZt%5C%5Cu0026q=85%5C%5Cu0026s=843d0563baa54c778891f942711ab938%22,%22dark%22:%22https://mintcdn.com/sapient-14d4e375/0RQiSxJPQv6MyuZt/images/lightsage-logo-with-text-dark.svg?fit=max%5C%5Cu0026auto=format%5C%5Cu0026n=0RQiSxJPQv6MyuZt%5C%5Cu0026q=85%5C%5Cu0026s=0ec933f6e5153f8392cb4c5f19b7017f%22%7D,%22favicon%22:%22https://mintcdn.com/sapient-14d4e375/lnqlKs8p%5C_hzadcGt/images/favicon.png?fit=max%5C%5Cu0026auto=format%5C%5Cu0026n=lnqlKs8p%5C_hzadcGt%5C%5Cu0026q=85%5C%5Cu0026s=358b3be56f25189cd6d5417fd300fefc%22,%22background%22:%7B%22color%22:%7B%22light%22:%22#FFFFFF%22,%22dark%22:%22#0D0C0C%22%7D%7D,%22navbar%22:%7B%22links%22:%5C%5B%7B%22href%22:%22https://lightsage.com%22,%22label%22:%22Homepage%22%7D%5C%5D,%22primary%22:%7B%22type%22:%22button%22,%22label%22:%22Dashboard%22,%22href%22:%22https://app.lightsage.com%22%7D%7D,%22seo%22:%7B%22indexing%22:%22all%22%7D,%22fonts%22:%7B%22family%22:%22Geist%22%7D,%22integrations%22:%7B%22ga4%22:%7B%22measurementId%22:%22G-417S0EJVMS%22%7D,%22posthog%22:%7B%22apiKey%22:%22phc%5C_yrA1TjjqeYfsoJEofjxd0Bw7cTrxs8N402k3NwusII7%22%7D%7D,%22contextual%22:%7B%22options%22:%5C%5B%22copy%22,%22chatgpt%22,%22cursor%22,%22vscode%22%5C%5D,%22display%22:%22header%22%7D,%22styling%22:%7B%22latex%22:false%7D,%22navigation%22:%7B%22pages%22:%5C%5B%5C%5D%7D%7D,%22deployment%22:%7B%22deploymentMetadataValue%22:%7B%22subdomain%22:%22sapient-14d4e375%22,%22hasAudioNarration%22:false,%22actualSubdomain%22:%22sapient-14d4e375%22,%22customDomains%22:%5C%5B%22lightsage.com%22%5C%5D,%22gitSource%22:%7B%22type%22:%22github%22,%22owner%22:%22lightsagehq%22,%22repo%22:%22docs%22,%22deployBranch%22:%22main%22,%22isPrivate%22:true,%22contentDirectory%22:%22%22,%22mountPath%22:%22%22,%22label%22:%22%22%7D,%22chroma%22:%7B%22liveDeploymentHistoryId%22:%226ae02893fa64afb3742fc617%22,%22collectionId%22:%225733d0e5-4574-4b13-bbeb-88d7bc3f6d01%22,%22schemaVersion%22:%22v3%22,%22latestBuiltDeploymentHistoryId%22:%226ae02893fa64afb3742fc617%22%7D,%22entitlements%22:%7B%22AI%5C_CHAT%22:%7B%22status%22:%22DISABLED%22%7D%7D,%22buildId%22:%226ae02c324c09e96410641fcb%22,%22clientVersion%22:%220.0.3971%22,%22searchFilterCounts%22:%5C%5B%7B%22language%22:%22default%22,%22tag%22:%22API){kind=link}
![https://mintlify.s3.us-west-1.amazonaws.com/sapient-14d4e375/images/mcp-icons/opencode.svg","href":"/mcp-reference/opencode"}\]}\]},{"tab":"API](https://mintlify.s3.us-west-1.amazonaws.com/sapient-14d4e375/images/mcp-icons/opencode.svg%22,%22href%22:%22/mcp-reference/opencode%22%7D%5C%5D%7D%5C%5D%7D,%7B%22tab%22:%22API){kind=link}