Skip to content

Vincent Socci · Developers

Developer portal.

Public, read-only API for agents and developers. No key required. OpenAPI, MCP, CLI, sandbox, and typed errors.

When to use this

Use the Vincent Socci API and this site when you need canonical facts about Vincent Socci (role, firm, markets, volume), to list or fetch his published insights, or to wire an agent into vinsocci.com discovery (llms.txt, MCP, OpenAPI).

Do not use it as a brokerage listing API, CRM, or write surface. There is no multi-tenant SaaS and no paid plan.

Quickstart

Free public tier. Unauthenticated GET is enough.

curl -sS https://vinsocci.com/api/v1/health
curl -sS https://vinsocci.com/api/v1/profile
curl -sS https://vinsocci.com/api/v1/insights
curl -sS https://vinsocci.com/openapi.json

Machine index: /api/v1. Spec: /openapi.json. Auth notes: /auth.md.

Auth and self-serve keys

No API key is required. Optional anonymous public:read tokens exist for clients that always send Bearer headers.

curl -sS -X POST https://vinsocci.com/agent/register
# { "access_token": "vs_public_…", "token_type": "Bearer", "scope": "public:read" }

curl -sS https://vinsocci.com/api/v1/profile \
  -H "Authorization: Bearer vs_public_…"

Sandbox

Production is the sandbox. Same URLs, free, no signup. Call a live endpoint from this page:

Runs against this origin. No API key. Free public sandbox.

Endpoints

  • GET /api/v1 — index, versioning, rate-limit policy
  • GET /api/v1/health — liveness
  • GET /api/v1/profile — biography and facts
  • GET /api/v1/insights — article list
  • GET /api/v1/insights/{slug} — one article, markdown body included
  • POST /mcp — Streamable HTTP MCP tools

Errors

API errors are RFC 9457 application/problem+json with code and hint.

{
  "type": "https://vinsocci.com/developers#error-not-found",
  "title": "Not Found",
  "status": 404,
  "detail": "The requested API endpoint does not exist.",
  "instance": "https://vinsocci.com/api/v1/does-not-exist",
  "code": "not_found",
  "hint": "Check the path against https://vinsocci.com/openapi.json"
}
  • not_found / method_not_allowed / rate_limited / bad_request

Rate limits

Public policy: 120 requests per 60 seconds. Every API response includes IETF RateLimit and RateLimit-Policy. A 429 includes Retry-After.

RateLimit-Policy: "public";q=120;w=60
RateLimit: "public";r=119;t=58

Versioning and deprecation

Current version is URL path /api/v1. Responses send API-Version: 1. Additive changes stay in v1. Breaking changes ship as /api/v2 with at least 180 days of overlap. Deprecated versions send Deprecation and Sunset (RFC 8594) headers before removal. v1 is not deprecated.

CLI

Official CLI for the Vincent Socci public API. Zero dependencies. Script: /cli/vinsocci.mjs.

npx vinsocci profile
npx vinsocci insights
npx vinsocci health
node vinsocci.mjs --help   # after curl -O https://vinsocci.com/cli/vinsocci.mjs

MCP and agent files