// DEVELOPER_PROTOCOL

Salman Ahmad Portfolio Developer Documentation & Agent Hub

Welcome to the official developer portal for Salman Ahmad's (ahmmikun) portfolio platform. Discover programmatically accessible REST APIs (v1), first-party Model Context Protocol (MCP) servers, official CLI tooling (npx salmanahmad), OpenAPI 3.1.0 specifications, RFC 9457 error schemas, and RFC rate-limiting headers.

OpenAPI 3.1.0 Spec

Fully typed OpenAPI schema with RFC 9457 error models and function-calling definitions.

View JSON

MCP Manifest

Streamable HTTP discovery manifest for Model Context Protocol AI agents.

View Manifest

llms.txt Index

Standard machine index with 'When to use this' agent guidance and NAP.

View llms.txt

XML Sitemap

Standard Sitemaps protocol indexing all canonical routes on salmanahmad.tech.

View Sitemap

1. Official CLI Tool (npx salmanahmad)

Zero-install terminal access for human developers, shell automations, and AI agents.

Salman Ahmad Portfolio provides an official CLI tool published under salmanahmad and ahmmikun. Run with zero installation via npx:

# Print interactive portfolio summary
npx salmanahmad bio

# Retrieve skills matrix as JSON for automated parsing
npx salmanahmad skills --category Backend --json

# Query software projects catalog matching a keyword
npx salmanahmad projects --filter ai --json

# Dispatch a verified contact message
npx salmanahmad contact --name "Jane Doe" --email "jane@example.com" --message "Project inquiry"

# Launch lightweight stdio Model Context Protocol (MCP) server
npx salmanahmad mcp

2. Model Context Protocol (MCP) Server

First-party tools exposed natively to Claude Desktop, Cursor, ChatGPT, and autonomous agents.

Connection Details

  • Streamable HTTP Endpoint: https://salmanahmad.tech/api/mcp
  • Versioned Endpoint: https://salmanahmad.tech/api/v1/mcp
  • Discovery Manifest: /.well-known/mcp.json
  • Protocol Version: 2024-11-05
  • Transport Support: Streamable HTTP, Server-Sent Events (SSE), JSON-RPC 2.0

Available MCP Tools

  • get_portfolio_summary: Returns professional bio, roles, metrics, and links.
  • get_skills: Returns categorized taxonomy of software engineering proficiencies.
  • get_projects: Returns software projects catalog with repository URLs and tech stacks.
  • get_developer_resources: Returns all machine-readable URLs and OpenAPI schemas.
  • send_contact_message: Submits a direct contact message to Salman Ahmad.

Example Claude Desktop Configuration

{
  "mcpServers": {
    "salman-ahmad-portfolio": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-everything", "https://salmanahmad.tech/api/mcp"]
    }
  }
}

3. Versioned REST API (v1)

Programmatic HTTP endpoints with URL path versioning, RFC 9457 error model, and RFC rate limits.

POST/api/v1/contact

Dispatches a contact inquiry. Requires username, email, and contact_message.

GET/api/v1/skills?category=Backend

Returns categorized skills matrix with optional query filtering.

GET/api/v1/projects?filter=bot

Queries software projects catalog with keyword filtering.

GET/api/v1/health

Uptime status and canonical discovery endpoint listing.

4. RFC 9457 Error Model & Rate Limits

Machine-readable error contracts and self-throttling headers for autonomous agents.

Standard Problem Details Schema

{
  "type": "https://salmanahmad.tech/docs/errors#validation-error",
  "title": "Validation Error",
  "status": 400,
  "code": "VALIDATION_ERROR",
  "message": "Missing required fields: username, email, and contact_message are required.",
  "resolution": "Supply username, email, and contact_message conforming to /openapi.json.",
  "instance": "/api/v1/contact"
}

RFC RateLimit Headers

  • RateLimit-Limit: Max requests allowed in sliding window (default: 60)
  • RateLimit-Remaining: Remaining requests in current window
  • RateLimit-Reset: Seconds until the rate limit resets
  • RateLimit-Policy: Policy directive (60;w=60)
  • Retry-After: Returned on HTTP 429 to signal required backoff seconds