Loading documentation
Research Desk
Deal Center
Library
Loading
The Model Context Protocol (MCP) lets other AI clients call tools from Corbis.
That means you can use Corbis research and data tools inside products like Claude, ChatGPT, Cursor, Claude Code, Codex, and other MCP-compatible clients instead of staying only inside the Corbis web app.
MCP is useful when you want to:
Claude Free supports one custom connector. Add a custom connector named Corbis using the universal MCP URL, then sign in with your Corbis account through OAuth. No API key is needed.
https://www.corbis.ai/api/mcp/universalhttps://www.corbis.ai/api/mcp/universal{
"mcpServers": {
"corbis": {
"url": "https://www.corbis.ai/api/mcp/universal"
}
}
}claude mcp add --transport http corbis https://www.corbis.ai/api/mcp/universal --header "Authorization: Bearer ${CORBIS_MCP_API_KEY}"This catalog is generated from Corbis's canonical MCP registry. Access depends on your account and key configuration.
| Tool | Name | Description | Category |
|---|---|---|---|
| corbis_sidebar | Corbis Research Workspace | Corbis native research extension. | research |
| corbis_thread | Corbis Thread Workspace | Corbis native research extension. | research |
| corbis_onboarding | Corbis Onboarding | Corbis native research extension. | research |
| search_mentions | Search Paper Mentions | Corbis native research extension. | research |
| search_papers | Search Papers | Hybrid academic paper search. | research |
| get_paper_details | Get Paper Details | Fetch full metadata for a single paper. | research |
| get_paper_details_batch | Get Paper Details Batch | Fetch full metadata for multiple papers in one call. | research |
| search | Search Corbis Papers | Paper search in the OpenAI search/fetch convention for deep-research clients. | research |
| fetch | Fetch Corbis Paper | Paper fetch in the OpenAI search/fetch convention for deep-research clients. | research |
| literature_search | Literature Search | Managed staged literature review and synthesis pipeline. | research |
| research_opportunity_map | Research Opportunity Map | Embedding-based candidate gap, bridge, and conflict mapper for research ideation. | research |
| literature_retrieve | Literature Retrieve | Retrieve paper candidates for local external-agent synthesis. | research |
| paper_discovery | Paper Discovery | Multi-facet paper discovery and deduped triage over the paper layer. | research |
| literature_positioning | Literature Positioning | Position a thesis against nearby paper-layer literature with verification-needed signals. | research |
| evidence_pack | Evidence Pack | Build paper-level evidence packs for claim-specific review. | research |
| claim_verification | Claim Verification | Premium paper-layer claim verification precheck with fail-closed sparse retrieval. | research |
| fred_search | FRED Search | Search FRED economic series metadata. | economic |
| fred_series_batch | FRED Series Batch | Fetch multiple FRED series in one call with transformed observation units, original rawUnits, and explicit transformation metadata. | economic |
| get_market_data | Get Market Data | Get a CRE market snapshot. | market |
| get_metric_definitions | Get Metric Definitions | Return schema and definitions for CRE market metrics. | market |
| compare_markets | Compare Markets | Compare multiple CRE markets side by side. | market |
| search_markets | Search Markets | Rank or search markets by metric. | market |
| screen_markets | Screen Markets | Multi-factor CRE market screening. | market |
| get_national_macro | Get National Macro | Fetch stored national macroeconomic indicators with requested/returned date ranges and row-limit truncation. Source freshness and ingestion completeness require separate verification. | market |
| get_market_trends | Get Market Trends | Fetch metro-level historical trend series. | market |
| get_cre_market | Get CRE Market | CRE market snapshot by property type with national benchmarks. | market |
| search_cre_markets | Search CRE Markets | Rank metros by a CRE metric within a property type. | market |
| get_cre_trend | Get CRE Trend | Annual CRE transaction trend for a metro. | market |
| search_cre_listings | Search CRE Listings | Live for-sale / for-lease CRE inventory. | market |
| get_cre_comps | Get CRE Comps | Individual securitized (CMBS) property comps. | market |
| get_cre_operating | Get CRE Operating Fundamentals | Same-store rent/NOI growth + occupancy by metro × sector (REIT supplementals). | market |
| get_reit_transaction_caps | Get REIT Transaction Caps | National by-sector REIT acquisition/disposition cap rates. | market |
| get_cbre_cap_rate_survey | Get CBRE Cap Rate Survey | CBRE Cap Rate Survey history and segment/class drill-downs (survey expectation, not closed deals). | market |
| internet_search | Web Search | Managed web search with Corbis-side summary. | web |
| read_web_page | Read Web Page | Extract a web page for analysis. | web |
| web_search_retrieve | Web Search Retrieve | Retrieve web result cards for local external-agent synthesis. | web |
| web_pages_retrieve | Web Pages Retrieve | Retrieve bounded page extracts for local external-agent synthesis. | web |
| deep_research | Deep Research | Run a managed multi-engine web research synthesis pass. | web |
| export_citations | Export Citations | Format supplied citation metadata into export files for MCP clients. | citation |
| render_citations | Render Citations | Render corpus-verified citations from OpenAlex IDs, DOI IDs, chat citation sets, document snapshots, or run IDs. | citation |
| top_cited_articles | Top Cited Articles | Rank highly cited papers within journals. | research |
| format_citation | Format Citation | Format citations in multiple styles. | citation |
| search_datasets | Search Datasets | Discover relevant external datasets with nullable absolute HTTP(S) links; invalid catalog link text is returned as null. | research |
| find_academic_identity | Find Research Identity | Search for the user research profile candidate. | identity |
| confirm_academic_identity | Confirm Research Identity | Link or unlink public research profile anchors. | identity |
| link_academic_identity | Link Research Identity | Link the authenticated user research identity after they confirm their public profile anchors. May refresh public evidence and research context. | identity |
| unlink_academic_identity | Unlink Research Identity | Remove the authenticated user research identity link after they request it. May refresh research context using public background searches. | identity |
| get_research_pulse | Get Research Pulse | Return the authenticated user research pulse; may refresh linked public OpenAlex or ORCID evidence. Reading usage may grant or refill credits and reset credit or workflow usage counters when account maintenance is due. | identity |
| get_data_freshness | Get Data Freshness | Aggregate data-through and last-refreshed signals for Corbis data sources. | market |
| retrieve_document | Retrieve Document | Retrieve an existing artifact document. | document |
| query_corbis | Query Corbis | Delegate a managed tool-grounded sub-query to Corbis. | workflow |
| query_corbis_retrieve | Query Corbis Retrieve | Retrieve compact Corbis evidence packets for local external-agent synthesis. | workflow |
| referee_report_evaluate | Evaluate Referee Report | Evaluate local external-agent referee report inputs and return a calibrated deliverable. | workflow |
| technical_audit_evaluate | Evaluate Technical Audit | Evaluate local external-agent technical audit findings and return a calibrated deliverable. | workflow |
| verify_bibtex | Verify BibTeX | Audit BibTeX reference lists for correctness and completeness. | citation |
The Corbis plugin is live in the Claude directory and requires a paid Claude plan. On paid Claude, this is the preferred setup. Open the listing from MCP Client Setup, install it, then connect by signing in with your Corbis account and approving access. No API key is needed.
On Claude Free, use a custom MCP connector instead; Claude Free supports one custom connector. This is also a fallback on managed Claude plans when your organization permits custom connectors but plugin installation is unavailable. Open the Claude custom connector fallback in MCP Client Setup, name it Corbis, paste your Corbis universal MCP URL, and sign in with your Corbis account to approve OAuth access. No API key is needed. Organization policy may require an administrator to enable access.
The ChatGPT directory plugin is coming soon. You can already use Corbis through a custom MCP connector with OAuth. Open ChatGPT setup from MCP Client Setup, name the connector Corbis, paste your Corbis universal MCP URL, and sign in with your Corbis account.
ChatGPT calls its custom connector setup New Plugin. That dialog creates your connection; it does not mean the Corbis directory plugin is available. No API key is needed.
Use Add to Cursor or the downloadable JSON in Settings → API Keys, then complete the browser sign-in and consent flow. The config contains the MCP URL alone, with no API key.
Create a personal MCP API key in Settings → API Keys. Copy it when it is shown: tokens are only revealed once. Settings provides a copyable Claude Code command and Codex configuration. The Claude Code command is also in MCP Client Setup.
For manual setups, use your Corbis app origin (scheme, host, and port if any) plus /api/mcp/universal. Send the key in an Authorization: Bearer … header. Prefer streamable HTTP unless your client requires another transport.
Personal MCP API keys — Created in Settings → API Keys. Use this path for clients that let you set a custom header (Claude Code, Codex, and similar): send the key as an Authorization: Bearer … header.
OAuth — Used when the client signs you in and you approve access in the web app. The Claude plugin or custom connector, ChatGPT custom connector, and Cursor use this path without a personal key. On paid Claude, prefer its plugin listing. Claude’s custom connector fallback, ChatGPT, and Cursor use the bare MCP URL to start sign-in.
OAuth access tokens use the same Authorization: Bearer … header style after you complete the client's login flow.
Security: Credentials in the URL query string (?apikey= / ?token=) are rejected in production — they leak through logs, referrers, and shared links. They work only against a local development server. Always use a Bearer header or OAuth.
Account-level access: Claude, ChatGPT, and Cursor OAuth connections use your account and approved scopes. They do not inherit a personal key’s tool allowlist or research defaults, and revoking a key does not revoke an OAuth connection. Manage approved OAuth clients in Settings → API Keys. Revoking a connection stops future authorization-code and refresh-token use; an already issued access token can remain valid for up to 24 hours.
OAuth scope and consent details for implementers are documented in lib/mcp/OAUTH2_IMPLEMENTATION.md in the repository (not required reading for basic API-key setup).
Prefer /api/mcp/universal for new setups. Other routes exist for compatibility and discovery:
/api/mcp/sse and /api/mcp/message — Legacy SSE transport pair for clients that need a dedicated SSE URL instead of streamable HTTP on the universal route./.well-known/oauth-protected-resource, /.well-known/oauth-authorization-server, /.well-known/openid-configuration — OAuth / OpenID discovery metadata for clients that probe well-known URLs./api/mcp/oauth/register, /api/mcp/oauth/authorize, /api/mcp/oauth/token — Dynamic registration, authorization, and token exchange for supported OAuth integrations.This section names routes only; it is not a full OAuth tutorial.
/api/mcp/universal unless you know you need the legacy path.No. Most Corbis MCP tools work on every Corbis plan, including Corbis Free: paper search, citation tools, FRED economic data, and the CRE market-data tools among them. A small set of advanced tools (such as deep research, web search and page reading, literature search, claim verification, the referee and technical-audit evaluators, and managed Corbis queries) is enterprise-only. Your exact tool list also depends on approved OAuth scopes or your key configuration, so the authoritative answer is the tools/list response on your own connection (the tool list your client shows is that response). The docs://tool-access MCP resource explains the tier, scope, and key-allowlist rules behind it, and your current plan and limits are in Corbis settings.
Claude’s plan requirements are separate: installing the Claude plugin requires a paid Claude plan, while Claude Free supports one custom MCP connector.
Yes. That is one of the main MCP use cases.
Yes. Approve each OAuth client through its sign-in flow. For bearer-key clients, create separate keys so you can revoke them independently.
Start in Settings → API Keys and check the endpoint plus your OAuth connection or bearer key, depending on the client. If that still fails, contact Corbis support.
If you are working from a checkout of the Corbis codebase:
docs/ai-sdk/mcp/ — Corbis MCP guides (Cursor plugin, Claude Code, Codex, and related).lib/mcp/CHATGPT_GUIDE.md — ChatGPT-oriented setup notes.The Model Context Protocol (MCP) lets other AI clients call tools from Corbis.
That means you can use Corbis research and data tools inside products like Claude, ChatGPT, Cursor, Claude Code, Codex, and other MCP-compatible clients instead of staying only inside the Corbis web app.
MCP is useful when you want to:
Claude Free supports one custom connector. Add a custom connector named Corbis using the universal MCP URL, then sign in with your Corbis account through OAuth. No API key is needed.
https://www.corbis.ai/api/mcp/universalhttps://www.corbis.ai/api/mcp/universal{
"mcpServers": {
"corbis": {
"url": "https://www.corbis.ai/api/mcp/universal"
}
}
}claude mcp add --transport http corbis https://www.corbis.ai/api/mcp/universal --header "Authorization: Bearer ${CORBIS_MCP_API_KEY}"This catalog is generated from Corbis's canonical MCP registry. Access depends on your account and key configuration.
| Tool | Name | Description | Category |
|---|---|---|---|
| corbis_sidebar | Corbis Research Workspace | Corbis native research extension. | research |
| corbis_thread | Corbis Thread Workspace | Corbis native research extension. | research |
| corbis_onboarding | Corbis Onboarding | Corbis native research extension. | research |
| search_mentions | Search Paper Mentions | Corbis native research extension. | research |
| search_papers | Search Papers | Hybrid academic paper search. | research |
| get_paper_details | Get Paper Details | Fetch full metadata for a single paper. | research |
| get_paper_details_batch | Get Paper Details Batch | Fetch full metadata for multiple papers in one call. | research |
| search | Search Corbis Papers | Paper search in the OpenAI search/fetch convention for deep-research clients. | research |
| fetch | Fetch Corbis Paper | Paper fetch in the OpenAI search/fetch convention for deep-research clients. | research |
| literature_search | Literature Search | Managed staged literature review and synthesis pipeline. | research |
| research_opportunity_map | Research Opportunity Map | Embedding-based candidate gap, bridge, and conflict mapper for research ideation. | research |
| literature_retrieve | Literature Retrieve | Retrieve paper candidates for local external-agent synthesis. | research |
| paper_discovery | Paper Discovery | Multi-facet paper discovery and deduped triage over the paper layer. | research |
| literature_positioning | Literature Positioning | Position a thesis against nearby paper-layer literature with verification-needed signals. | research |
| evidence_pack | Evidence Pack | Build paper-level evidence packs for claim-specific review. | research |
| claim_verification | Claim Verification | Premium paper-layer claim verification precheck with fail-closed sparse retrieval. | research |
| fred_search | FRED Search | Search FRED economic series metadata. | economic |
| fred_series_batch | FRED Series Batch | Fetch multiple FRED series in one call with transformed observation units, original rawUnits, and explicit transformation metadata. | economic |
| get_market_data | Get Market Data | Get a CRE market snapshot. | market |
| get_metric_definitions | Get Metric Definitions | Return schema and definitions for CRE market metrics. | market |
| compare_markets | Compare Markets | Compare multiple CRE markets side by side. | market |
| search_markets | Search Markets | Rank or search markets by metric. | market |
| screen_markets | Screen Markets | Multi-factor CRE market screening. | market |
| get_national_macro | Get National Macro | Fetch stored national macroeconomic indicators with requested/returned date ranges and row-limit truncation. Source freshness and ingestion completeness require separate verification. | market |
| get_market_trends | Get Market Trends | Fetch metro-level historical trend series. | market |
| get_cre_market | Get CRE Market | CRE market snapshot by property type with national benchmarks. | market |
| search_cre_markets | Search CRE Markets | Rank metros by a CRE metric within a property type. | market |
| get_cre_trend | Get CRE Trend | Annual CRE transaction trend for a metro. | market |
| search_cre_listings | Search CRE Listings | Live for-sale / for-lease CRE inventory. | market |
| get_cre_comps | Get CRE Comps | Individual securitized (CMBS) property comps. | market |
| get_cre_operating | Get CRE Operating Fundamentals | Same-store rent/NOI growth + occupancy by metro × sector (REIT supplementals). | market |
| get_reit_transaction_caps | Get REIT Transaction Caps | National by-sector REIT acquisition/disposition cap rates. | market |
| get_cbre_cap_rate_survey | Get CBRE Cap Rate Survey | CBRE Cap Rate Survey history and segment/class drill-downs (survey expectation, not closed deals). | market |
| internet_search | Web Search | Managed web search with Corbis-side summary. | web |
| read_web_page | Read Web Page | Extract a web page for analysis. | web |
| web_search_retrieve | Web Search Retrieve | Retrieve web result cards for local external-agent synthesis. | web |
| web_pages_retrieve | Web Pages Retrieve | Retrieve bounded page extracts for local external-agent synthesis. | web |
| deep_research | Deep Research | Run a managed multi-engine web research synthesis pass. | web |
| export_citations | Export Citations | Format supplied citation metadata into export files for MCP clients. | citation |
| render_citations | Render Citations | Render corpus-verified citations from OpenAlex IDs, DOI IDs, chat citation sets, document snapshots, or run IDs. | citation |
| top_cited_articles | Top Cited Articles | Rank highly cited papers within journals. | research |
| format_citation | Format Citation | Format citations in multiple styles. | citation |
| search_datasets | Search Datasets | Discover relevant external datasets with nullable absolute HTTP(S) links; invalid catalog link text is returned as null. | research |
| find_academic_identity | Find Research Identity | Search for the user research profile candidate. | identity |
| confirm_academic_identity | Confirm Research Identity | Link or unlink public research profile anchors. | identity |
| link_academic_identity | Link Research Identity | Link the authenticated user research identity after they confirm their public profile anchors. May refresh public evidence and research context. | identity |
| unlink_academic_identity | Unlink Research Identity | Remove the authenticated user research identity link after they request it. May refresh research context using public background searches. | identity |
| get_research_pulse | Get Research Pulse | Return the authenticated user research pulse; may refresh linked public OpenAlex or ORCID evidence. Reading usage may grant or refill credits and reset credit or workflow usage counters when account maintenance is due. | identity |
| get_data_freshness | Get Data Freshness | Aggregate data-through and last-refreshed signals for Corbis data sources. | market |
| retrieve_document | Retrieve Document | Retrieve an existing artifact document. | document |
| query_corbis | Query Corbis | Delegate a managed tool-grounded sub-query to Corbis. | workflow |
| query_corbis_retrieve | Query Corbis Retrieve | Retrieve compact Corbis evidence packets for local external-agent synthesis. | workflow |
| referee_report_evaluate | Evaluate Referee Report | Evaluate local external-agent referee report inputs and return a calibrated deliverable. | workflow |
| technical_audit_evaluate | Evaluate Technical Audit | Evaluate local external-agent technical audit findings and return a calibrated deliverable. | workflow |
| verify_bibtex | Verify BibTeX | Audit BibTeX reference lists for correctness and completeness. | citation |
The Corbis plugin is live in the Claude directory and requires a paid Claude plan. On paid Claude, this is the preferred setup. Open the listing from MCP Client Setup, install it, then connect by signing in with your Corbis account and approving access. No API key is needed.
On Claude Free, use a custom MCP connector instead; Claude Free supports one custom connector. This is also a fallback on managed Claude plans when your organization permits custom connectors but plugin installation is unavailable. Open the Claude custom connector fallback in MCP Client Setup, name it Corbis, paste your Corbis universal MCP URL, and sign in with your Corbis account to approve OAuth access. No API key is needed. Organization policy may require an administrator to enable access.
The ChatGPT directory plugin is coming soon. You can already use Corbis through a custom MCP connector with OAuth. Open ChatGPT setup from MCP Client Setup, name the connector Corbis, paste your Corbis universal MCP URL, and sign in with your Corbis account.
ChatGPT calls its custom connector setup New Plugin. That dialog creates your connection; it does not mean the Corbis directory plugin is available. No API key is needed.
Use Add to Cursor or the downloadable JSON in Settings → API Keys, then complete the browser sign-in and consent flow. The config contains the MCP URL alone, with no API key.
Create a personal MCP API key in Settings → API Keys. Copy it when it is shown: tokens are only revealed once. Settings provides a copyable Claude Code command and Codex configuration. The Claude Code command is also in MCP Client Setup.
For manual setups, use your Corbis app origin (scheme, host, and port if any) plus /api/mcp/universal. Send the key in an Authorization: Bearer … header. Prefer streamable HTTP unless your client requires another transport.
Personal MCP API keys — Created in Settings → API Keys. Use this path for clients that let you set a custom header (Claude Code, Codex, and similar): send the key as an Authorization: Bearer … header.
OAuth — Used when the client signs you in and you approve access in the web app. The Claude plugin or custom connector, ChatGPT custom connector, and Cursor use this path without a personal key. On paid Claude, prefer its plugin listing. Claude’s custom connector fallback, ChatGPT, and Cursor use the bare MCP URL to start sign-in.
OAuth access tokens use the same Authorization: Bearer … header style after you complete the client's login flow.
Security: Credentials in the URL query string (?apikey= / ?token=) are rejected in production — they leak through logs, referrers, and shared links. They work only against a local development server. Always use a Bearer header or OAuth.
Account-level access: Claude, ChatGPT, and Cursor OAuth connections use your account and approved scopes. They do not inherit a personal key’s tool allowlist or research defaults, and revoking a key does not revoke an OAuth connection. Manage approved OAuth clients in Settings → API Keys. Revoking a connection stops future authorization-code and refresh-token use; an already issued access token can remain valid for up to 24 hours.
OAuth scope and consent details for implementers are documented in lib/mcp/OAUTH2_IMPLEMENTATION.md in the repository (not required reading for basic API-key setup).
Prefer /api/mcp/universal for new setups. Other routes exist for compatibility and discovery:
/api/mcp/sse and /api/mcp/message — Legacy SSE transport pair for clients that need a dedicated SSE URL instead of streamable HTTP on the universal route./.well-known/oauth-protected-resource, /.well-known/oauth-authorization-server, /.well-known/openid-configuration — OAuth / OpenID discovery metadata for clients that probe well-known URLs./api/mcp/oauth/register, /api/mcp/oauth/authorize, /api/mcp/oauth/token — Dynamic registration, authorization, and token exchange for supported OAuth integrations.This section names routes only; it is not a full OAuth tutorial.
/api/mcp/universal unless you know you need the legacy path.No. Most Corbis MCP tools work on every Corbis plan, including Corbis Free: paper search, citation tools, FRED economic data, and the CRE market-data tools among them. A small set of advanced tools (such as deep research, web search and page reading, literature search, claim verification, the referee and technical-audit evaluators, and managed Corbis queries) is enterprise-only. Your exact tool list also depends on approved OAuth scopes or your key configuration, so the authoritative answer is the tools/list response on your own connection (the tool list your client shows is that response). The docs://tool-access MCP resource explains the tier, scope, and key-allowlist rules behind it, and your current plan and limits are in Corbis settings.
Claude’s plan requirements are separate: installing the Claude plugin requires a paid Claude plan, while Claude Free supports one custom MCP connector.
Yes. That is one of the main MCP use cases.
Yes. Approve each OAuth client through its sign-in flow. For bearer-key clients, create separate keys so you can revoke them independently.
Start in Settings → API Keys and check the endpoint plus your OAuth connection or bearer key, depending on the client. If that still fails, contact Corbis support.
If you are working from a checkout of the Corbis codebase:
docs/ai-sdk/mcp/ — Corbis MCP guides (Cursor plugin, Claude Code, Codex, and related).lib/mcp/CHATGPT_GUIDE.md — ChatGPT-oriented setup notes.