NudgeLink MCP API
The mcp API from NudgeLink — 6 operation(s) for mcp.
The mcp API from NudgeLink — 6 operation(s) for mcp.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/nudgelink-co:nudgelink-co-mcp-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: NudgeLink MCP API
version: 0.1.0
tags:
- name: MCP
paths:
/api/v1/mcp/consent/{request_id}:
get:
tags:
- MCP
summary: Describe Consent Request
description: Describe a parked authorization request so the page can render it.
operationId: describe_consent_request_api_v1_mcp_consent__request_id__get
security:
- HTTPBearer: []
parameters:
- name: request_id
in: path
required: true
schema:
type: string
title: Request Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ConsentRequestOut'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/mcp/consent/approve:
post:
tags:
- MCP
summary: Approve Consent
description: 'Grant the assistant access as the signed-in user.
``user.id`` is the ONLY source of the tenant that gets stamped onto the
authorization — never anything from the request body. That is what keeps
one user from approving an assistant into someone else''s account.'
operationId: approve_consent_api_v1_mcp_consent_approve_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ConsentDecision'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ConsentRedirectOut'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
/api/v1/mcp/consent/deny:
post:
tags:
- MCP
summary: Deny Consent
description: 'Refuse, and hand back the RFC 6749 error redirect.
The request is burned here rather than left to expire, so a user who
changes their mind cannot have the same screen approved later.'
operationId: deny_consent_api_v1_mcp_consent_deny_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ConsentDecision'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ConsentRedirectOut'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
/api/v1/mcp/consent:
get:
tags:
- MCP
summary: List Connected Assistants
description: 'Assistants this account has connected — the settings view.
Scoped to ``user.id``; there is no parameter that could widen it.'
operationId: list_connected_assistants_api_v1_mcp_consent_get
responses:
'200':
description: Successful Response
content:
application/json:
schema:
items:
additionalProperties: true
type: object
type: array
title: Response List Connected Assistants Api V1 Mcp Consent Get
security:
- HTTPBearer: []
/api/v1/mcp/consent/linkedin-tools:
post:
tags:
- MCP
summary: Set Linkedin Tools
description: 'Allow / forbid ONE connected assistant to use LinkedIn-automating tools.
Directory edition (2026-09-23): off by default. Scoped to ``user.id``; an
unknown or revoked connection is a 404 rather than a silent no-op. Switching
ON is refused (409) for an assistant that may not be offered the tools
(ChatGPT until its next plugin version, or ``MCP_LINKEDIN_TOOLS=false``);
switching OFF always works.'
operationId: set_linkedin_tools_api_v1_mcp_consent_linkedin_tools_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/LinkedInToolsRequest'
required: true
responses:
'204':
description: Successful Response
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
/api/v1/mcp/consent/disconnect:
post:
tags:
- MCP
summary: Disconnect Assistant
description: 'Revoke an assistant''s access for THIS account only.
Revokes refresh grants and approved codes, which stops renewal. Tool calls
check the authorization and grant revocation live, so existing access
tokens are rejected too, including on an already-open MCP session.'
operationId: disconnect_assistant_api_v1_mcp_consent_disconnect_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/DisconnectRequest'
required: true
responses:
'204':
description: Successful Response
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
components:
schemas:
DisconnectRequest:
properties:
client_id:
type: string
maxLength: 64
minLength: 1
title: Client Id
type: object
required:
- client_id
title: DisconnectRequest
ConsentRedirectOut:
properties:
redirect_url:
type: string
title: Redirect Url
type: object
required:
- redirect_url
title: ConsentRedirectOut
ConsentDecision:
properties:
request_id:
type: string
maxLength: 128
minLength: 16
title: Request Id
type: object
required:
- request_id
title: ConsentDecision
ConsentRequestOut:
properties:
client_id:
type: string
title: Client Id
client_name:
type: string
title: Client Name
scopes:
items:
type: string
type: array
title: Scopes
redirect_host:
type: string
title: Redirect Host
expires_at:
type: string
title: Expires At
type: object
required:
- client_id
- client_name
- scopes
- redirect_host
- expires_at
title: ConsentRequestOut
description: What the consent screen shows. No redirect URI, only its host.
LinkedInToolsRequest:
properties:
client_id:
type: string
maxLength: 64
minLength: 1
title: Client Id
enabled:
type: boolean
title: Enabled
type: object
required:
- client_id
- enabled
title: LinkedInToolsRequest
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
securitySchemes:
HTTPBearer:
type: http
scheme: bearer