notfair-co .well Known API
The .well Known API from notfair-co — 2 operation(s) for .well known.
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/notfair-co:notfair-co-well-known-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
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. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: NotFair API and MCP Reference .well Known API
version: 1.0.0
description: Public discovery and the existing NotFair Streamable HTTP MCP API for advertising, search, analytics, CRM, and WordPress integrations. Tool operations require a workspace OAuth bearer token. This is a JSON-RPC MCP API, not a REST facade for individual platform operations. Connect an MCP client for initialization, authentication, tool discovery and execution. Platform access depends on connected accounts, permissions and enabled integrations.
contact:
name: NotFair support
url: https://notfair.co/contact
email: tong@notfair.co
servers:
- url: https://notfair.co
description: Canonical NotFair origin
- url: https://www.notfair.co
description: Supported legacy OAuth/MCP origin; discover OAuth metadata on the same origin you connect to.
tags:
- name: .well Known
paths:
/.well-known/mcp/server-card.json:
get:
operationId: getNotFairMcpServerCard
summary: Discover public MCP tool schemas
description: Returns the generated static metadata for NotFair's canonical compact tools, including input schemas, descriptions and annotations. No customer data is included. Runtime tools/list and tools/call remain authenticated.
security: []
responses:
'200':
description: Static server metadata matching the compact MCP registrar.
content:
application/json:
schema:
$ref: '#/components/schemas/ServerCard'
tags:
- .well Known
/.well-known/oauth-protected-resource/api/mcp/notfair:
get:
operationId: getNotFairProtectedResource
summary: Discover MCP authorization servers
description: RFC 9728 metadata for the canonical NotFair MCP resource. Discover authorization server metadata on the returned origin. Preserve that origin through OAuth and validate callback issuer matching exactly.
security: []
responses:
'200':
description: Protected resource metadata.
content:
application/json:
schema:
type: object
properties:
resource:
type: string
format: uri
authorization_servers:
type: array
items:
type: string
format: uri
resource_name:
type: string
resource_documentation:
type: string
format: uri
resource_policy_uri:
type: string
format: uri
resource_tos_uri:
type: string
format: uri
logo_uri:
type: string
format: uri
required:
- resource
- authorization_servers
- resource_name
- resource_documentation
- resource_policy_uri
- resource_tos_uri
- logo_uri
tags:
- .well Known
components:
schemas:
Tool:
type: object
properties:
name:
type: string
title:
type: string
description:
type: string
inputSchema:
type: object
additionalProperties: true
outputSchema:
type: object
additionalProperties: true
annotations:
type: object
properties:
title:
type: string
readOnlyHint:
type: boolean
destructiveHint:
type: boolean
idempotentHint:
type: boolean
openWorldHint:
type: boolean
required: []
required:
- name
- inputSchema
ServerCard:
type: object
properties:
serverInfo:
type: object
properties:
name:
type: string
version:
type: string
required:
- name
- version
authentication:
type: object
properties:
required:
type: boolean
const: true
schemes:
type: array
items:
type: string
const: oauth2
required:
- required
- schemes
tools:
type: array
items:
$ref: '#/components/schemas/Tool'
resources:
type: array
items:
type: object
properties:
uri:
type: string
name:
type: string
description:
type: string
mimeType:
type: string
required:
- uri
- name
prompts:
type: array
items:
type: object
properties:
name:
type: string
description:
type: string
arguments:
type: array
items:
type: object
properties:
name:
type: string
description:
type: string
required:
type: boolean
required:
- name
required:
- name
required:
- serverInfo
- authentication
- tools
- resources
- prompts
securitySchemes:
NotFairOAuth:
type: oauth2
description: Clients self-register at https://notfair.co/api/oauth/register (RFC 7591). The authorization step opens NotFair sign-in, where a person signs up or signs in, chooses a workspace and connects platforms; an agent cannot create the account or approve platform access for them. Authorization code with PKCE (S256) and RFC 8707 resource=https://notfair.co/api/mcp/notfair. Discover authorization server metadata at /.well-known/oauth-authorization-server. For www clients, use that origin for discovery, issuer and resource throughout the flow.
flows:
authorizationCode:
authorizationUrl: https://notfair.co/api/oauth/authorize
tokenUrl: https://notfair.co/api/oauth/token
scopes: {}
externalDocs:
description: NotFair API documentation and examples
url: https://notfair.co/docs/reference/api