NudgeLink MCP API

The mcp API from NudgeLink — 6 operation(s) for mcp.

GitHub OpenAPI

Operations 6

POST /api/v1/mcp/consent/approve Approve Consent #
POST /api/v1/mcp/consent/deny Deny Consent #
POST /api/v1/mcp/consent/linkedin-tools Set Linkedin Tools #
POST /api/v1/mcp/consent/disconnect Disconnect Assistant #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/nudgelink-co:nudgelink-co-mcp-api"
All apis
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.

Get an API 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 Specification

nudgelink-co-mcp-api-openapi.yml Raw ↑
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