This site is built for machines too

Query the data (API)

The knowledge graph is also a live, queryable backend. The canonical contract is the OpenAPI 3.1 spec; responses are CDN-cached per deploy (check the X-KG-Version header).

• GET/api/kg/nodes

  List or filter entities (nodes).

  type

  Node type: Person, Skill, Project, Organization, Client, Event, Award

  q

  Fuzzy name/alias search (accent & case-insensitive)

  limit

  Max results (default 100, max 1000)

  offset

  Pagination offset (default 0)

  curl "https://androsguirado.dev/api/kg/nodes?type=Skill&q=flash"

• GET/api/kg/edges

  List or filter relationships (edges).

  type

  Edge type: KNOWS_SKILL, WORKED_ON, BUILT_AT, USED_SKILL, VIA_AGENCY, FOR_CLIENT, PARTICIPATED_IN, AT, SPOKE_AT, RECEIVED, AWARDED_FOR

  from

  Source entity id

  to

  Target entity id

  limit

  Max results (default 100, max 1000)

  offset

  Pagination offset (default 0)

  curl "https://androsguirado.dev/api/kg/edges?type=USED_SKILL&limit=5"

• GET/api/kg/query

  Run a named declarative query — returns results plus a per-step traversal trace.

  typerequired

  Query name: projects_by_year, projects_by_client, skills_by_project, clients_by_skill, projects_by_skill, skills_evolution, projects_by_relevance

  explain

  Return only the traversal plan, without executing

  …

  Per-query params — see the named queries below

  curl "https://androsguirado.dev/api/kg/query?type=projects_by_relevance&min=0.9"

• POST/mcp

  MCP server (JSON-RPC 2.0, streamable HTTP, stateless). Methods: initialize, ping, tools/list, tools/call.

  curl -X POST "https://androsguirado.dev/mcp" -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

• GET/api/status

  Health & freshness probe — API liveness, graph version (= X-KG-Version), schemaVersion, lastUpdated and live entity/relationship counts. Also at /status.

  curl "https://androsguirado.dev/api/status"

Named queries

Each query returns its results plus a per-step traversal trace; add &explain=1 to get the plan without executing.

• projects_by_year→ project[]

  Projects created in a given year or year range.

  year

  int — single year

  from

  int — range start (alt. to year)

  to

  int — range end

  curl "https://androsguirado.dev/api/kg/query?type=projects_by_year&year=2008"

• projects_by_client→ project[]

  Projects commissioned by a client (also matches studios/agencies acting as client).

  client

  entity id or name, e.g. "Volkswagen" or "client_volkswagen"

  curl "https://androsguirado.dev/api/kg/query?type=projects_by_client&client=Volkswagen"

• skills_by_project→ skill[]

  Skills used in a project.

  project

  entity id or name, e.g. "Beetle dream"

  curl "https://androsguirado.dev/api/kg/query?type=skills_by_project&project=Beetle dream"

• clients_by_skill→ client[]

  Clients of the projects where a skill was used (2-hop: skill ← USED_SKILL ← project → FOR_CLIENT → client).

  skill

  entity id or name, e.g. "PHP"

  from

  int — optional year range over the projects

  to

  int

  curl "https://androsguirado.dev/api/kg/query?type=clients_by_skill&skill=PHP"

• projects_by_skill→ project[]

  Projects where a skill was used, optionally restricted to a year range.

  skill

  entity id or name, e.g. "flash"

  from

  int — optional range start

  to

  int

  curl "https://androsguirado.dev/api/kg/query?type=projects_by_skill&skill=flash&from=2003&to=2010"

• skills_evolution→ {year, projects, skillsStarted[], skillsUsed: {id, name, projects}[]}[]

  Year-by-year skill evolution: per year, the skills used in projects (with project counts), the skills first adopted that year, and the project total. Defaults to the full active range.

  from

  int — range start (default: first project year)

  to

  int — range end (default: last project year)

  curl "https://androsguirado.dev/api/kg/query?type=skills_evolution&from=2003&to=2010"

• projects_by_relevance→ project[]

  Projects at or above a relevance threshold (0–1), most relevant first. Optional year range.

  min

  float 0–1 — relevance threshold (default 0.7)

  from

  int — optional range start

  to

  int

  curl "https://androsguirado.dev/api/kg/query?type=projects_by_relevance&min=0.9"

MCP server

Connect an MCP-capable agent (Claude, etc.):

claude mcp add --transport http andros-kg https://androsguirado.dev/mcp

• getProjectsByYear— Projects worked on in a year or year range
• getProjectsByClient— Projects commissioned by a client (fuzzy name or entity id)
• getSkillsEvolution— Year-by-year skill usage and adoption between two years
• queryKnowledgeGraph— Generic declarative query (projects_by_year, projects_by_client, skills_by_project, clients_by_skill, projects_by_skill, skills_evolution)
• searchEntities— Search entities by name/alias, optional type filter