NEOLearn

McpService

MCP access: tokens for your own AI tools (any MCP client) to drive the Studio you have open in your browser, your Studio sessions and the calls they made.

Updated October 21, 2026

On this page

MCP access: let your own AI tools (any Model Context Protocol client) drive the NEO Studio you have open in your browser. You make a token per client in Settings → MCP access, choosing what it may do (its scopes); the client connects to {api}/mcp/studio with Authorization: Bearer neomcp_..., and the platform relays its calls to a Studio you're signed in to. Calls that need a scope the token lacks for deleting, publishing or launching processes wait for you to allow them in the Studio's MCP Connections panel. Tokens are shown once, stored only as a hash, and can be revoked at any time. Every method is a POST with a JSON body; see the overview for the protocol, authentication and errors.

Summary#

MethodAuthDescription
CreateMcpTokenAccountMakes a token (shown once). Scopes beyond read, edit and build (fs, destructive, publish, process, secrets.write) need you to confirm it's you first: a passkey or authenticator step-up when the account has one, otherwise the account's password.
ListMcpTokensAccountYour tokens, newest first (never the tokens themselves).
RevokeMcpTokenAccountRevokes a token: its next call is refused, and calls of it waiting in a Studio are dropped.
ListStudioSessionsAccountYour Studio sessions that accept MCP clients (open now, and the last few days'), newest first.
ListMcpCallsAccountThe MCP calls your tokens made, newest first.

Methods#

CreateMcpToken#

Makes a token (shown once). Scopes beyond read, edit and build (fs, destructive, publish, process, secrets.write) need you to confirm it's you first: a passkey or authenticator step-up when the account has one, otherwise the account's password.

HTTP
POST /neo.platform.v1.McpService/CreateMcpToken
Content-Type: application/json

Auth: A signed-in account. Guests are refused.

Request: CreateMcpTokenRequest. Response: CreateMcpTokenResponse.

ListMcpTokens#

Your tokens, newest first (never the tokens themselves).

HTTP
POST /neo.platform.v1.McpService/ListMcpTokens
Content-Type: application/json

Auth: A signed-in account. Guests are refused.

Request: ListMcpTokensRequest. Response: ListMcpTokensResponse.

RevokeMcpToken#

Revokes a token: its next call is refused, and calls of it waiting in a Studio are dropped.

HTTP
POST /neo.platform.v1.McpService/RevokeMcpToken
Content-Type: application/json

Auth: A signed-in account. Guests are refused.

Request: McpTokenRef. Response: ListMcpTokensResponse.

ListStudioSessions#

Your Studio sessions that accept MCP clients (open now, and the last few days'), newest first.

HTTP
POST /neo.platform.v1.McpService/ListStudioSessions
Content-Type: application/json

Auth: A signed-in account. Guests are refused.

Request: ListStudioSessionsRequest. Response: ListStudioSessionsResponse.

ListMcpCalls#

The MCP calls your tokens made, newest first.

HTTP
POST /neo.platform.v1.McpService/ListMcpCalls
Content-Type: application/json

Auth: A signed-in account. Guests are refused.

Request: ListMcpCallsRequest. Response: ListMcpCallsResponse.

Types#

CreateMcpTokenRequest#

FieldTypeDescription
namestringwho it's for ("Claude Code on my laptop")
scopesarray of stringread is always included
expiresInDaysnumber0: never expires; at most 365
passwordstringthe account's password, when sensitive scopes are asked for and the account has no passkey or authenticator

CreateMcpTokenResponse#

FieldTypeDescription
tokenMcpToken
secretstringBearer neomcp_...: shown once
endpointstringwhere MCP clients connect

ListMcpCallsRequest#

FieldTypeDescription
limitnumberup to 200 (default 50)
beforestringthe last call of the previous page's at (older calls come next)
tokenIdstringonly this token's (mct_...)

ListMcpCallsResponse#

FieldTypeDescription
callsarray of McpCall

ListMcpTokensRequest#

FieldTypeDescription
includeInactivebooleaninclude revoked and expired tokens

ListMcpTokensResponse#

FieldTypeDescription
tokensarray of McpToken
scopesarray of McpScopeevery scope a token may have
endpointstringwhere MCP clients connect

ListStudioSessionsRequest#

No fields: send {}.

ListStudioSessionsResponse#

FieldTypeDescription
sessionsarray of StudioSession

McpCall#

FieldTypeDescription
atstring
tokenIdstringmct_...
tokenNamestring
sessionIdstringmss_... (empty: none was reached)
methodstringtools/call, tools/list, resources/read,...
toolstringthe tool, for tools/call
outcomestringok, error, refused, held, timeout, no_studio, rate_limited, too_large
msnumber

McpScope#

FieldTypeDescription
namestring
descriptionstring
heldWithoutbooleancalls needing it wait for you in the Studio when the token lacks it (instead of being refused)
sensitivebooleanasking for it needs a confirmation that it's you

McpToken#

FieldTypeDescription
idstringmct_...
namestring
prefixstringthe token's first characters (neomcp_...), to tell tokens apart
scopesarray of stringread, edit, fs, build, destructive, publish, process, secrets.write
createdAtstring
lastUsedAtstringempty: never used
expiresAtstringempty: never expires
revokedAtstringempty: active
callsstring (int64)

McpTokenRef#

FieldTypeDescription
tokenIdstring

StudioSession#

FieldTypeDescription
idstringmss_...
titlestring
projectstring
connectedAtstring
lastSeenAtstring
closedAtstringempty: open now
liveboolean
recentTokenIdsarray of stringthe tokens that called it in the last day (mct_...)
endpointstringits own endpoint (pins this session)

See also#