Use Uma Dica from your AI agent

Uma Dica is a remote MCP server at https://api.umadica.com/mcp (Streamable HTTP). Tools: search_events, search_places, get_place, list_categories, list_regions. All are read-only.

Without a key you get a free preview: Plano Piloto, up to 5 results per question, events for the next 7 days, basic fields. With a key (get one free, upgrade any time) your plan applies: the whole DF, addresses, descriptions in Portuguese and English, and map links. Send the key as a Bearer token. Keep it in a secret, never in a prompt.

Claude

In the Claude app

Settings → Connectors → Add custom connector. Name: Uma Dica. URL: https://api.umadica.com/mcp. That gives the free preview.

Claude API (MCP connector)

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: mcp-client-2025-11-20" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 1500,
    "messages": [{"role": "user", "content": "Jazz in Brasília this weekend?"}],
    "mcp_servers": [{"type": "url", "url": "https://api.umadica.com/mcp", "name": "umadica",
                     "authorization_token": "'"$UMADICA_API_KEY"'"}],
    "tools": [{"type": "mcp_toolset", "mcp_server_name": "umadica"}]
  }'

OpenAI (Responses API and Agents SDK)

curl https://api.openai.com/v1/responses \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "model": "gpt-5",
    "input": "Best cafés in Asa Norte?",
    "tools": [{"type": "mcp", "server_label": "umadica", "server_url": "https://api.umadica.com/mcp",
               "authorization": "'"$UMADICA_API_KEY"'", "require_approval": "never"}]
  }'

Use any current model. In ChatGPT, turn on developer mode and add https://api.umadica.com/mcp as a connector.

Grok (xAI API)

curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "model": "grok-4",
    "input": [{"role": "user", "content": "Samba this Friday in Brasília?"}],
    "tools": [{"type": "mcp", "server_label": "umadica", "server_url": "https://api.umadica.com/mcp",
               "server_description": "Curated events and places in Brasília",
               "authorization": "'"$UMADICA_API_KEY"'"}]
  }'

Use any current Grok model.

Anything else

Any MCP client that speaks Streamable HTTP works. Agents that don't use MCP can call the plain JSON API: see the docs, openapi.json and llms.txt.

Fair use

Use only what the tools return and credit "Uma Dica". The free preview is shared by everyone, so busy apps should use their own key.