Remote MCP · OAuth · Read only

Give your agent a live view of Solana.

Nexusol MCP connects compatible personal agents to Nexusol ecosystem intelligence, synthesized news, and your account profile. You authorize access in the browser; passwords and API keys are never copied into agent configuration.

Quickstart

One endpoint, browser-based authorization

Add the remote server URL to your MCP client. The client discovers Nexusol OAuth automatically, opens a browser, and asks you to approve the requested read scopes.

MCP endpoint
https://www.nexusol.app/api/mcp
  1. 1

    Add the server

    Use the URL in your agent's MCP settings.

  2. 2

    Sign in

    Authenticate with the same Google or X account you use on Nexusol.

  3. 3

    Approve access

    Review the requested scopes, then allow or deny the connection.

Personal agents

Connect your preferred client

Codex CLI

Codex detects OAuth discovery and opens your browser to authorize.

terminal
codex mcp add nexusol --url https://www.nexusol.app/api/mcp

Claude Code

Add the HTTP server, start Claude Code, then use /mcp to authenticate.

terminal
claude mcp add --transport http nexusol https://www.nexusol.app/api/mcp
claude
/mcp

Cursor

Add this project-level configuration, then choose Needs login in Cursor MCP settings.

.cursor/mcp.json
{
  "mcpServers": {
    "nexusol": {
      "url": "https://www.nexusol.app/api/mcp"
    }
  }
}

ChatGPT

Enable Developer mode, create a custom connector named Nexusol, use the endpoint above, and select OAuth authentication.

Settings → Connectors → Advanced settings → Developer mode → Create connector

Custom TypeScript agent

Use an OAuth-capable MCP client provider. HTTP is the recommended remote transport.

TypeScript
import { createMCPClient } from "@ai-sdk/mcp";

const client = await createMCPClient({
  transport: {
    type: "http",
    url: "https://www.nexusol.app/api/mcp",
    authProvider: yourOAuthClientProvider,
  },
});

const tools = await client.tools();

Tool reference

Available read-only tools

search_projects

Search active projects in the Nexusol ecosystem directory.

ecosystem:read
get_project

Get one ecosystem project by its exact slug.

ecosystem:read
list_latest_news

List recent synthesized Solana news, with optional search.

news:read
get_article

Read one Nexusol news article by slug.

news:read
get_my_profile

Read your public-facing Nexusol profile fields.

profile:read

Security

OAuth protects every request

No pasted secrets

Compatible clients discover OAuth and store their own authorization securely.

Scoped access

Each tool checks its required scope before returning data.

Read-only release

This first version cannot create, edit, delete, trade, post, or message.

Your account

The profile tool returns public-facing fields only—not provider IDs or internal auth records.

Only connect the canonical endpoint shown above. During authorization, verify that your browser is on nexusol.app before approving access.

Help

Troubleshooting

The client says authentication is required

Open the client's MCP settings and choose Login, Authenticate, or Reconnect. The Nexusol server intentionally returns an OAuth challenge before authorization.

The browser returns to the app

Normal Nexusol sign-in finishes in the app. Start the MCP connection again from your agent so it can attach its signed OAuth request.

A tool reports a missing scope

Disconnect and reconnect the server, then approve the requested scope. Denied scopes are never silently added later.

The server does not appear in my client

Confirm the client supports remote HTTP MCP and OAuth. Older clients that only support local stdio servers cannot connect directly.

Documentation approach

This guide uses the task-first structure common to OpenAI and Vercel docs: quickstart first, client-specific examples, reference, security, then troubleshooting. It is built with the project's existing Next.js and Tailwind stack. If the documentation grows into many pages, Fumadocs is the recommended next layer for MDX content, search, sidebar navigation, and generated page trees.