Advertise GraphQL schema
there are SO MANY WAYS to get people + LLMs to go to figure out our graphql schema.
I think we should implement as many as possible.
1. llms.txt
2. /.well-known/api.json delivers a payload that describes how to get to the graphql endpoint & schema
3. add a response header to every request to /graphql `Link: </.well-known/graphql-schema>; rel="describedby"`
4. Update our github to link to llms.txt, point to /.well-known/api.json
5. Create a Public API document on our marketing page & link to the resources there
6. Write a skill with example queries
7. Write an MCP server
8. write a skill that uses our MCP server
Example api.json
```json
{
"name": "Your API",
"graphql_endpoint": "/graphql",
"graphql_schema": "/.well-known/graphql-schema",
"graphql_sdl": "/graphql/schema.graphql",
"auth": {
"type": "bearer"
}
}
```
0 条评论