# AssistX MCP server

> Model Context Protocol server. Endpoint: https://mcp-server-zbq3avqqaq-nw.a.run.app/mcp
> Protocol 2026-07-28 (and every handshake revision back to 2024-11-05).
> Authentication: X-API-Key. Stateless — no session ids are issued.

Tool discovery is per-credential: `tools/list` returns only what your key
may use, so a tool's absence is expected rather than an error.

## Tools visible without any scope (20)

- **compare_geolocation_providers** — Compare geolocation results from multiple providers for accuracy analysis.
- **discuss_case_study** — Return a detailed case-study narrative for a selected project.
- **get_document** — Fetch a document from the database.
- **get_ip_location** — Get geolocation information for an IP address.
- **get_session_location** — Get IP location for a specific authenticated session.
- **get_user_ip_location** — Get the current user's IP address and location information.
- **get_widget** — Get a widget definition by ID.
- **github_read** — List Michelangelo Zampogna's public GitHub repositories.
- **linkedin_profile_read** — Read Michelangelo Zampogna's own LinkedIn profile — name, photo, locale.
- **list_agent_assets** — List downloadable setup artefacts for importing this server into an agent.
- **list_available_tools** — Dynamically list all available MCP tools with their descriptions.
- **list_widgets** — List widget definitions stored in Firestore (collection: widgets).
- **medium_read** — Read Michelangelo Zampogna's own Medium articles.
- **query_documents** — Query documents from the database with semantic search support.
- **save_conversation** — Save a conversation to the database.
- **search_industries** — Check industry experience.
- **search_proficiencies** — Search skills and proficiencies.
- **search_projects** — Search portfolio projects and case studies.
- **search_work_experience** — Search work experience for specific roles, companies, or outcomes.
- **youtube_read** — List Michelangelo Zampogna's YouTube uploads, each playable.

## Documents

- [Client setup](https://mcp-server-zbq3avqqaq-nw.a.run.app/agent-assets/SKILL.md): the contracts discovery cannot express
- [Tool export (JSON)](https://mcp-server-zbq3avqqaq-nw.a.run.app/agent-assets/mcp-server.json)

## Sibling surface

- [Page-local tools (WebMCP)](https://assistx.michelangelozampogna.com/for-agents):
  the portfolio site itself registers page-local tools in WebMCP-enabled
  browsers — a browser agent can search the work, read a case study,
  drive the page and deliver a message without an MCP client.

Generated from 09acb08354d8.